---
title: "Busca recebíveis por parâmetros de busca"
method: POST
path: "/credit-card-receivables"
tags: ["Credit Card Receivables"]
---

# Busca recebíveis por parâmetros de busca

`POST /credit-card-receivables`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/credit-card-receivables`
- Auth: OAuth 2
  - Authorization code: `https://id.btgpactual.com/oauth2/authorize`
  - Token URL: `https://id.btgpactual.com/oauth2/token` scopes: `brn:btg:empresas:credit:receivables-credit-card`

Obtém os recebíveis disponíveis para antecipação de acordo com os parâmetros informados e visualiza informações de taxa média e prazo médio.

## Request body

- object
  - `valorDesejado` string: Valor desejado para a operação
  - `bandeiras` string[]: Lista de bandeiras de cartão de crédito. Pode ser preenchido ou vazio (nesse caso, busca por todos).
  - `sacados` string[]: Lista de CNPJs das credenciadoras. Pode ser preenchido ou vazio (nesse caso, busca por todos).
  - `tipoConsulta` 'PorValorDesembolso' | 'PorValorBruto': Tipo de consulta
  - `tipoAproximacaoValorDesejado` 'Exata' | 'PorCima' | 'PorBaixo': Tipo de aproximação do valor desejado

## Response `200`

Sugestão de recebíveis realizada com sucesso

- object
  - `averageTerm` number: Prazo médio da operação
  - `averageRate` number: Taxa média ponderada
  - `recebiveis` object[]
    - `status` string: Status do recebível
    - `maximumDisbursementAmount` string: Valor máximo de desembolso
    - `id` number: Identificador do recebível
    - `payeeId` string: CNPJ do estabelecimento comercial
    - `payerId` string: CNPJ da credenciadora
    - `maturityDate` string, date: Data de vencimento do recebível
    - `scheme` string: Bandeira do cartão de crédito
    - `maturityAmount` string: Valor de vencimento do recebível
    - `suggestedDisbursementAmount` string: Valor de desembolso sugerido do recebível
    - `suggestedMaturityAmount` string: Valor de vencimento sugerido do recebível

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
