---
title: "Listar contas a receber"
method: GET
path: "/contas-receber"
tags: ["Contas a receber"]
---

# Listar contas a receber

`GET /contas-receber`

## Query parameters

- `nomeCliente` string
- `situacao` 'aberto' | 'cancelada' | 'pago' | 'parcial' | 'prevista' | 'atrasadas' | 'emissao'
- `dataInicialEmissao` string
- `dataFinalEmissao` string
- `dataInicialVencimento` string
- `dataFinalVencimento` string
- `numeroDocumento` string
- `numeroBanco` string
- `idNota` integer
- `idVenda` integer
- `marcadores` string[]
- `orderBy` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` ListagemContasReceberResponseModel[]
    - `id` integer, nullable
    - `situacao` 'aberto' | 'cancelada' | 'pago' | 'parcial' | 'prevista' | 'atrasadas' | 'emissao', nullable — - aberto - Aberto - cancelada - Cancelada - pago - Pago - parcial - Parcial - prevista - Prevista - atrasadas - Atrasadas - emissao - Emissao
    - `data` string, nullable
    - `dataVencimento` string, nullable
    - `historico` string, nullable
    - `valor` number, float, nullable
    - `numeroDocumento` string, nullable
    - `numeroBanco` string, nullable
    - `serieDocumento` string, nullable
    - `cliente` ContatoModelResponse — 
      - `nome` string, nullable
      - `codigo` string, nullable
      - `fantasia` string, nullable
      - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable — - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
      - `cpfCnpj` string, nullable
      - `inscricaoEstadual` string, nullable
      - `rg` string, nullable
      - `telefone` string, nullable
      - `celular` string, nullable
      - `email` string, nullable
      - `endereco` EnderecoModel — 
        - `endereco` string, nullable
        - `numero` string, nullable
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `municipio` string, nullable
        - `cep` string, nullable
        - `uf` string, nullable
        - `pais` string, nullable
      - `id` integer
    - `quantidadeParcelasAntecipadas` integer, nullable
    - `saldo` number, float, nullable
  - `paginacao` PaginatedResultModel — 
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/olist/apis/olist-erp-api-v3.md) · [All operations](https://skmtc.net/olist/apis/olist-erp-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olist/olist-erp-api-v3/versions/c351400bb11f/schema)