---
title: "Consultar lista de cobranças recorrentes."
method: GET
path: "/cobr"
tags: ["CobR"]
---

# Consultar lista de cobranças recorrentes.

`GET /cobr`

Endpoint para consultar cobranças recorrentes através de parâmetros como início, fim, idRec, cpf, cnpj, status e convênio.

## Query parameters

- `inicio` string, date-time, required — Filtra os registros cuja data de criação seja maior ou igual que a data de início. Respeita RFC 3339.
- `fim` string, date-time, required — Filtra os registros cuja data de criação seja menor ou igual que a data de fim. Respeita RFC 3339.
- `idRec` string — Filtro pelo Identificador da Recorrência.
- `cpf` string — Filtro pelo CPF do devedor. Não pode ser utilizado ao mesmo tempo que o CNPJ.
- `cnpj` string — Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF.
- `status` string — Filtro pelo status da recorrência.
- `convenio` string — Filtro pelo convênio associado.
- `paginacao.paginaAtual` integer — Página a ser retornada pela consulta. Se não for informada, o PSP assumirá que será 0.
- `paginacao.itensPorPagina` integer — Quantidade máxima de registros retornados em cada página. Apenas a última página pode conter uma quantidade menor de registros.

## Response `200`

Lista de cobranças recorrentes.

- CobsRConsultadas — unresolved $ref

## Other responses

- `403` — Requisição de participante autenticado que viola alguma regra de autorização.
- `503` — Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.

## Changes

- **2025-03-17** `918a1c847724` — 4 info
  - added the new optional `query` request parameter `convenio`
  - added the optional property `cobsr/items/allOf[subschema #1: Cobrança Recorrente Completa]/allOf[subschema #10: Histórico de Tentativas da Cobrança Recorrente]/tentativas/items/rejeicao` to the response with the `200` status
  - added the optional property `parametros/recebedor` to the response with the `200` status
  - removed the `AG12` enum value from the `cobsr/items/allOf[subschema #1: Cobrança Recorrente Completa]/allOf[subschema #9: Histórico de Atualização da Cobrança Recorrente]/encerramento/oneOf[subschema #2]/rejeicao/codigo` response property for the response status `200`
- **2024-11-29** `d3ea69fe1056` — 2 info
  - the response property `cobsr` became required for the status `200`
  - the response property `parametros` became required for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/bacen/apis/api-pix/changes/cobr/get.md)

---

[API](https://skmtc.dev/bacen/apis/api-pix.md) · [All operations](https://skmtc.dev/bacen/apis/api-pix/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bacen/api-pix/revisions/918a1c847724/schema)