---
title: "Consultar lista de recorrências."
method: GET
path: "/rec"
tags: ["Rec"]
---

# Consultar lista de recorrências.

`GET /rec`

Consultar lista de recorrências.

## 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.
- `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.
- `locationPresente` boolean
- `status` string — Filtro pelo status da cobrança.
- `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`

OK

- RecsConsultadas
  - `parametros` ParametrosConsultaCob — [DEPRECADO] Parâmetros utilizados para a realização de uma consulta de cobranças.
    - `inicio` string, date-time, required — Data inicial utilizada na consulta. Respeita RFC 3339.
    - `fim` string, date-time, required — Data de fim utilizada na consulta. Respeita RFC 3339.
    - `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.
    - `locationPresente` boolean — Filtro pela existência de location vinculada.
    - `status` string — Filtro pelo status das cobranças.
    - `paginacao` Paginacao, required
      - `paginaAtual` integer, required — Número da página recuperada.
      - `itensPorPagina` integer, required — Quantidade de registros retornado na página.
      - `quantidadeDePaginas` integer, required — Quantidade de páginas disponíveis para consulta.
      - `quantidadeTotalDeItens` integer, required — Quantidade total de itens disponíveis de acordo com os parâmetros informados.
  - `recs` RecCompleta[] — 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

- **2024-08-30** `e60160879b89` — 1 info
  - endpoint added
- **2020-06-29** `5967a4b6f934` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bacen/apis/api-pix/changes/rec/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/e60160879b89/schema)