# Buscar Assinatura
`GET /v1/subscriptions/:subscriptionId`
**Área:** Assinaturas

**Scopes necessários:** `subscriptions/read`

Retorna os detalhes completos de uma assinatura específica.

A resposta inclui: `customer` (dados do cliente), `items` (itens da assinatura), `upgrades` (mudanças de plano pendentes), `billingCycles` (histórico de ciclos) e `coupon` (cupom aplicado, se houver).

Case de uso:

_Como SaaS, quero consultar o status e os itens de uma assinatura específica para exibir na área do cliente._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `subscriptionId` | **sim** | ID da assinatura (ex: sub_xxx) - required |

### Resposta 200 — 200

```json
{
  "subscriptionId": "sub_xxx",
  "status": "ACTIVE",
  "customer": {},
  "items": [],
  "upgrades": [],
  "billingCycles": [],
  "coupon": null
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Assinatura não encontrada",
        "code": "SUBSCRIPTION_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-buscar-assinatura
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json