Retrieve a ReservePlan Preview
GET / v1 / reserve / plans /:id
Retrieve a ReservePlan.
Parameters
- id string Required The identifier of the ReservePlan to retrieve.
Returns
Returns a ReservePlan object.
Response
{ "id": "resplan_61SxrVOzQu6XIJSCx41Q8rCFhzAUW", "object": "reserve.plan", "created": 1753380438, "created_by": "application", "currency": "usd", "disabled_at": null, "livemode": false, "metadata": {}, "percent": 15, "rolling_release": { "days_after_charge": 30, "expires_on": 1755972438 }, "status": "active", "type": "rolling_release"}
List ReservePlans Preview
GET / v1 / reserve / plans
Returns a list of ReservePlans previously created. The ReservePlans are returned in sorted order, with the most recent ReservePlans appearing first.
Parameters
No parameters.
More parameters
- ending _ before string
- limit integer
- starting _ after string
Returns
A dictionary with a data property that contains an array of up to limit ReservePlans, starting after ReservePlan starting_after and ending before ReservePlan ending_before. Each entry in the array is a separate ReservePlan object. If no more ReservePlans are available, the resulting array will be empty.
cURL
Response
Disable a ReservePlan Preview
POST / v1 / reserve / plans /:id / disable
Disables a ReservePlan by transitioning it to a disabled state.
All associated ReserveHolds release asynchronously.
Note: This action is irreversible - a disabled ReservePlan cannot be re-enabled.
Parameters
- id string Required The identifier of the ReservePlan to disable.
Returns
Returns the updated ReservePlan object.
cURL
Response
{ "id": "resplan_61SxrVOzQu6XIJSCx41Q8rCFhzAUW", "object": "reserve.plan", "created": 1753380438, "created_by": "application", "currency": "usd", "disabled_at": null, "livemode": false, "metadata": {}, "percent": 15, "rolling_release": { "days_after_charge": 30, "expires_on": 1755972438 }, "status": "disabling", "type": "rolling_release"}