⌘K

Listar Pagamentos

Liste os pagamentos de boleto realizados pela sua conta, com suporte a paginação.

Use o campo id de cada item para consultar os detalhes completos do pagamento em GET /billets/{id}.

GET/api/v2/billets

Lista os pagamentos de boleto realizados, ordenados do mais recente para o mais antigo. Requer o escopo billets.read.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2 (escopo billets.read)

Parametros de Query

Nome	Tipo	Obrigatorio	Descricao
`page`	integer	Opcional	Número da página a consultar.
`perPage`	integer	Opcional	Quantidade de itens por página.

Exemplo de Response

{
  "meta": {
    "total": 100,
    "limit": 10,
    "offset": 1
  },
  "data": [
    {
      "eventDate": "2026-06-12T16: 45:22Z",
      "id": 776543210,
      "digitableCode": "00190000090267490000732810452179696530000015075",
      "status": "LIQUIDATED",
      "transactionType": "BILLET",
      "idempotencyKey": "billet-req-id-001",
      "creditDebitType": "DEBIT",
      "transactionAmount": {
        "currency": "BRL",
        "amount": 150.75
      }
    }
  ]
}

Exemplos de Codigo

curl -X GET "https://pagamentos.basspago.com.br/api/v2/billets?page=1&perPage=10" \
  --cert ./client.crt \
  --key ./client.key \
  -H "Authorization: Bearer {access_token}"