---
title: "Lista até 20 assinaturas da própria conta neste produto."
method: GET
path: "/api/credito/assinaturas"
---

# Lista até 20 assinaturas da própria conta neste produto.

`GET /api/credito/assinaturas`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/credito/assinaturas`
- Auth: none declared

Exige venda mensal ativa ou homologação habilitada e pagamento de teste autorizado pelo servidor. Sem essa autorização, responde 404. Filtra conta, produto, recebedor e ambiente. Não consulta o Asaas ou conta a tabela. A oferta aceita permanece disponível quando o catálogo deixa de vender essa oferta. Sandbox exige bilhete válido. A query completa admite até 640 caracteres, incluindo o cursor.
Returns: { itens[{recurso,id,oferta_id,oferta,estado,simulado,pagamento_em,criado_em,atualizado_em,cancelamento_em,cancelado_em}], proximo, simulado }

## Query parameters

- `dev` string
- `x402_dev` string
- `cursor` string
- `recurso` string

## Headers

- `X-X402-Dev` string

## Response `200`

{ itens[{recurso,id,oferta_id,oferta,estado,simulado,pagamento_em,criado_em,atualizado_em,cancelamento_em,cancelado_em}], proximo, simulado }

- object
  - `itens` RegistroDeAssinatura[], required: Até 20 registros da própria conta.
    - `recurso` string, required: Recurso do produto: até 256 caracteres, sem controles. Filtra a assinatura da própria conta; vazio indica compra por conta.
    - `id` string, required: ID local de 32 caracteres hexadecimais; identifica a consulta e o cancelamento.
    - `oferta_id` string, required: ID da oferta aceita.
    - `oferta` OfertaDeAssinatura, required
      - `id` string, required: ID da oferta: 2 a 64 caracteres; letra inicial, letras minúsculas, números, hífen ou underscore.
      - `produto` string, required: Produto da oferta; mesmo formato do ID.
      - `versao` integer, required: Versão de 1 a 1.000.000.
      - `preco_centavos` integer, required: Preço mensal em centavos: de 500 a 1.000.000.
      - `moeda` string, required: Moeda fixa: BRL.
      - `ciclo` string, required: Periodicidade fixa: MONTHLY.
      - `renovacao_automatica` boolean, required: true: repete a cobrança mensal até o cancelamento.
      - `compromisso_meses` integer, required: 1: um período mensal.
      - `cancelamento` string, required: stop_future_charges: interrompe novas cobranças.
      - `acesso_pago` string, required: until_paid_period_end: mantém o acesso até o fim do período pago.
      - `teste_dias` integer, required: Prazo configurado de 0 a 30 dias. O catálogo não concede teste ou benefício.
      - `conversao_teste` string, required: opt_in: o teste não contrata ou renova por inferência.
      - `beneficios` BeneficioDeAssinatura[], required: De 1 a 8 capacidades distintas por período pago.
        - `sku` string, required: Capacidade do produto: letra minúscula seguida de letras, números ou underscore; até 64 caracteres.
        - `quantidade` integer, required: Unidades de 1 a 1.000.000 para cada período pago.
      - `hash` string, required: SHA-256 da oferta completa: 64 caracteres hexadecimais minúsculos.
    - `estado` string, required: criando, inconclusiva, checkout, aguardando_pagamento, ativa, cancelando, cancelada, falhou ou expirada.
    - `simulado` boolean, required: Ambiente gravado pelo servidor: true para sandbox, false para produção.
    - `pagamento_em` string, nullable, required: Null na contratação por API. Registros antigos podem ter link HTTPS Asaas no estado checkout.
    - `criado_em` string, required: Data e hora UTC da criação da assinatura.
    - `atualizado_em` string, required: Data e hora UTC da última alteração.
    - `cancelamento_em` string, nullable, required: Data e hora UTC do pedido de cancelamento, ou null.
    - `cancelado_em` string, nullable, required: Data e hora UTC do cancelamento confirmado, ou null.
  - `proximo` string, nullable, required: Cursor da próxima página, ou null.
  - `simulado` boolean, required: Ambiente autorizado pelo servidor para este pedido.

## Other responses

- `400`: Corpo, query, oferta, aceite, cartão ou ambiente inválido; cartão recusado.
- `401`: Sessão ausente ou inválida; chave de API não autoriza estes pedidos.
- `403`: Origem ou cookie inválido; na escrita, proteção CSRF inválida.
- `404`: Venda e homologação não autorizadas; assinatura inexistente, de outra conta, produto, recebedor ou ambiente.
- `431`: Cabeçalho de cookies acima de 8 KiB.
- `503`: Conta, banco, configuração ou provedor indisponível; limite de quatro operações simultâneas atingido.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)