Retrieve a single subscription

Retrieves the current data of a subscription by ID.

Use this operation for one-off queries, validation, or reconciliation of a subscription that has already been identified. The response represents the current state of the subscription and does not include the list of payments it has generated.

To query the payments already generated, use List payments of a subscription.

When the ID provided does not identify a subscription accessible by the authenticated account, the query returns 404.

📘

Tracking changes

To track creation, updates, deactivation, or removal of the subscription, use Webhooks instead of repeatedly querying this endpoint.

Use this GET for one-off retrieval or reconciliation.

See the Webhook events for subscriptions.

Related content

Guides

Path Params
string
required

Unique subscription identifier in Asaas

Responses

403

Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json