> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autorizou.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar Assinatura

> Retorna o estado atual de uma assinatura, incluindo acesso, ciclo e próxima cobrança.

Fonte da verdade sobre uma assinatura. Use sempre que precisar decidir com certeza se o cliente tem acesso, sem depender do último webhook.

<ParamField path="id" type="string" required>
  O `id` (uuid) da assinatura devolvido na criação.
</ParamField>

## Resposta

<ResponseField name="id" type="string">Identificador (uuid) da assinatura.</ResponseField>
<ResponseField name="state" type="string">O momento da assinatura. Ver [Ciclo de vida e estados](/api-reference/subscriptions/lifecycle).</ResponseField>
<ResponseField name="has_access" type="boolean">**Libere seu serviço por aqui.** `true` = o cliente deve ter acesso.</ResponseField>
<ResponseField name="current_cycle" type="integer">Quantos ciclos já foram cobrados.</ResponseField>
<ResponseField name="next_charge_at" type="string">Data da próxima cobrança (ou o fim do período pago, se `canceled`).</ResponseField>
<ResponseField name="next_charge_amount" type="integer">Valor do próximo ciclo, em centavos (segue a régua congelada).</ResponseField>
<ResponseField name="interval" type="string">`weekly`, `monthly`, `quarterly`, `half-yearly` ou `yearly`.</ResponseField>
<ResponseField name="max_cycles" type="integer">Total de ciclos combinados (ou `null` se indefinido).</ResponseField>
<ResponseField name="successful_charges" type="integer">Cobranças bem-sucedidas até agora.</ResponseField>
<ResponseField name="trial_days" type="integer">Dias de teste grátis, se houver.</ResponseField>
<ResponseField name="canceled_at" type="string">Quando foi cancelada (ou `null`).</ResponseField>

```json Resposta 200 theme={null}
{
  "id": "1e24d112-3a6d-4d13-a3f7-9366a232d35a",
  "state": "active",
  "has_access": true,
  "cycle": 3,
  "current_cycle": 3,
  "interval": "monthly",
  "next_charge_amount": 4900,
  "next_charge_at": "2026-09-18",
  "max_cycles": null,
  "successful_charges": 3,
  "trial_days": 0,
  "canceled_at": null
}
```

<Info>Assinatura de outro lojista responde **404**. É o isolamento funcionando, não um erro de rota.</Info>