Get a subscription

Get subscription details

get

This endpoint retrieves the details of a specific subscription by ID.

Path parameters

subscription_idinteger · int64Required

Unique numeric identifier of the subscription to retrieve.

Example: 219

Header parameters

Content-TypestringRequired

Media type of the body sent to the API.

Default: application/json

X-Datestring · date-timeRequired

ISO8601 Datetime with Timezone (yyyy-MM-dd'T'HH:mm:ssZ)

X-LoginstringRequired

Merchant X-Login API Key.

AuthorizationstringRequired

Authorization control hash.

X-Idempotency-KeystringOptional

Unique idempotency key for ensuring that the same request is not processed more than once.

Responses

200

Subscription details retrieved successfully

application/json

420

Subscription does not exist

application/json

500

Generic Error

application/json

get

HTTPcURLJavaScriptPython

GET /v3/subscriptions/{subscription_id} HTTP/1.1
Host: api-stg.directa24.com
Content-Type: application/json
X-Date: 2025-08-29T18:58:40.740Z
X-Login: text
Authorization: text
Accept: */*

{
  "id": 219,
  "status": "PENDING",
  "start_date": "2020-10-10",
  "end_date": "2020-10-17",
  "last_renovation_date": "2020-10-03",
  "creation_date": "2025-05-28T15:58:20",
  "subscription_plan": "WEEKLY",
  "plan_unit": 1,
  "amount": 21.9,
  "auto_renewal": true,
  "last_modified_date": "2025-02-18T13:49:16",
  "renewals": 2,
  "cancellation_date": null,
  "currency": "BRL",
  "last_charge_date": "2020-10-03",
  "payment_method": "VI",
  "invoice_id": "INV-2020-0001",
  "error_url": "https://example.com/error",
  "success_url": "https://example.com/success",
  "back_url": "https://example.com/back",
  "description": "Suscripción Semanal",
  "country": "BR",
  "deposits": [
    {
      "deposit_id": "301596732",
      "status": "COMPLETED"
    }
  ]
}