SUQODocs
User GuideAPI ReferenceSDKs
Subscriptions

Retrieve a subscription

Return a single subscription belonging to your account.

GET
/subscriptions/{id}/

Authorization

ApiKey
AuthorizationBearer <token>

API key issued to the partner, sent with the Bearer prefix — for example: Authorization: Bearer sk_live_abc123.

In: header

Path Parameters

id*string

UUID of the subscription.

Formatuuid
id*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/subscriptions/string/"
{  "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627",  "status": "pending_checkout",  "is_active": true,  "client": {    "phone": "string",    "full_name": "string",    "email": "string",    "address": "string",    "billing": {      "business_name": "string",      "email": "string",      "address": "string",      "pan_vat": "string"    },    "shipping": {      "phone": "string",      "full_name": "string",      "email": "string",      "address": "string"    }  },  "product": {    "product_id": "0d012afa-f885-4e65-aeca-37e27701e2d1",    "name": "string",    "plan_name": "string",    "pbp_id": "string",    "label": "string",    "price": "string",    "currency": "string"  },  "current_period_start": "2019-08-24T14:15:22Z",  "current_period_end": "2019-08-24T14:15:22Z",  "next_billing_cycle": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z"}

Update a subscription's next billing cycle POST

Move a subscription's next billing date. The date must be today or later, and one-time purchases cannot be rescheduled.

Cancel a subscription POST

Schedule cancellation at the end of the current billing period; the subscription stays usable until then. One-time purchases cannot be cancelled.