Consultar assinatura
GET
/v1/subscriptions/{id}
Retorna os detalhes completos da assinatura, incluindo produtos, ciclos e o histórico de cobranças.
Autorizações
bearerAuth
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Tipo
HTTP (bearer)
Parâmetros
Parâmetros de Caminho
id*
Identificador da assinatura.
Tipo
Obrigatóriointeger
Exemplo
10Respostas
Detalhes da assinatura retornados com sucesso.
application/json
JSON "data": { "subscription_id": 10, "status": "ACTIVE", "products": [ { "name": "Camiseta Preta", "shopify_product_id": null, "variant_id": null, "product_id": 55, "sku": "SKU-1", "quantity": 1, "price": 199.9, "image_url": null, "compare_at_price": null } ], "value": 199.9, "freight_value": 19.9, "interval": "month", "interval_count": 1, "current_cycle": 3, "completed_cycles": 2, "max_cycles": 12, "customer": { "name": "Maria Silva", "document": "12345678909", "phone": "11999999999", "address": { "street": "Rua São Bento", "number": "111", "complement": "Bloco 7", "district": "Centro", "city": "São Paulo", "state": "SP", "postcode": "01010000" } }, "payment": { "payment_info": { "brand": "visa", "final": "1234", "expiration": "12/2029" } }, "next_charge_at": "2026-08-15 00:00:00", "last_charge_at": "15/07/2026", "charges": [ { "cycle": 2, "order_id": 12347, "shopify_order_id": null, "charged_at": "15/07/2026", "value": 199.9, "status": "paid" } ], "created_at": "2026-06-15 10:00:00", "canceled_at": null, "paused_from": null, "paused_until": null }
{
}
GET
/v1/subscriptions/{id}