---
title: "Listar cobranças"
method: GET
path: "/charges"
tags: ["Cobranças"]
---

# Listar cobranças

`GET /charges`

## Request

- Base URL: `https://api.transfeera.com`
- URL: `https://api.transfeera.com/charges`
- Auth: HTTP bearer

## Query parameters

- `receivable_status` string[]
- `created_at__gte` string, date-time
- `created_at__lte` string, date-time
- `received_at__gte` string, date-time
- `received_at__lte` string, date-time
- `page_cursor` string
- `page_size` integer

## Response `200`

OK

- object
  - `items` ChargeResponse[], required
    - `id` string, uuid: ID da cobrança
    - `payment_methods` string[]
    - `payer` object: Dados do pagador
      - `name` string: Nome do pagador
      - `trade_name` string: Nome fantasia do pagador
      - `tax_id` string: Número do documento CPF/CNPJ
      - `address` ChargeAddress: Endereço
        - `street` string, required: Logradouro
        - `number` string, required: Número
        - `complement` string: Complemento
        - `district` string, required: Bairro
        - `city` string, required: Cidade
        - `state` string, required: UF
        - `postal_code` string, required: CEP
    - `receiver` object: Dados do recebedor
      - `name` string: Nome do recebedor
      - `trade_name` string: Nome fantasia do recebedor
      - `tax_id` string: Número do documento CPF/CNPJ
      - `pix_key` string: Chave Pix
      - `address` ChargeAddress: Endereço
        - `street` string, required: Logradouro
        - `number` string, required: Número
        - `complement` string: Complemento
        - `district` string, required: Bairro
        - `city` string, required: Cidade
        - `state` string, required: UF
        - `postal_code` string, required: CEP
    - `external_id` string: ID externo para integração
    - `receivables` object[]: Recebíveis
      - `id` string, uuid: ID do recebível
      - `status` 'created' | 'processing' | 'paid' | 'refunded' | 'canceling' | 'canceled' | 'failed': Status
      - `amount` integer: Valor da cobrança
      - `due_date` string, date: Data do vencimento
      - `expiration_date` string, date: Data de expiração da cobrança
      - `fine_amount` integer: Valor da multa
      - `fine_percent` number, float: Percentual da multa
      - `fine_type` 'fixed' | 'percentage': Tipo da multa
      - `interest_amount` integer: Valor dos juros
      - `interest_percent` number, float: Percentual dos juros
      - `interest_type` 'fixed_per_day' | 'fixed_per_working_day' | 'percentage_per_month' | 'percentage_per_month_working_days': Tipo dos juros
      - `discount_amount` integer: Valor do desconto
      - `discount_percent` number, float: Percentual do desconto
      - `discount_dates` object[]: Datas para desconto
        - `amount` integer: Valor do desconto
        - `percent` number, float: Percentual do desconto
        - `date` string, date: Data limite para o desconto
      - `discount_type` 'fixed_until_informed_dates' | 'percentage_until_informed_dates' | 'fixed_per_anticipated_day' | 'fixed_per_anticipated_working_day' | 'percentage_per_anticipated_day' | 'percentage_per_anticipated_working_day': Tipo do desconto
      - `description` string: Descrição
      - `qrcode` object: QR Code
        - `id` string, uuid: ID do QR Code
        - `emv_payload` string: EMV Payload
      - `boleto` object: Boleto
        - `id` string, uuid: ID do boleto
        - `barcode` string: Código de barras
        - `linha_digitavel` string: Linha digitável
        - `identification_number` string: Número de identificação
        - `type` string: Tipo do boleto
      - `automatic_pix` object: Pix Automático
        - `authorization_id` string, uuid: ID da autorização
        - `frequency` string: Frequência da recorrência
        - `retry_policy` string: Política de retentativa
        - `start_date` string, date: Data de início da autorização
        - `end_date` string, date: Data fim da autorização
        - `fixed_amount` string: Valor fixo
        - `max_amount_floor` string: Piso para valor máximo
        - `identifier` string: Identificador da autorização
      - `payments` object[]: Pagamentos
        - `id` string, uuid: ID do pagamento
        - `amount` integer: Valor pago
        - `receipt_url` string: URL do recibo
        - `paid_with` 'boleto' | 'pix': Método de pagamento
        - `paid_by` object: Dados do pagador
          - `name` string: Nome do pagador
          - `tax_id` string: Número do documento CPF (mascarado)/CNPJ
        - `created_at` string, date-time: Data de criação do pagamento
        - `updated_at` string, date-time: Data de atualização do pagamento
      - `created_at` string, date-time: Data de criação do recebível
      - `updated_at` string, date-time: Data de atualização do recebível
    - `created_at` string, date-time: Data de criação da cobrança
    - `updated_at` string, date-time: Data de atualização da cobrança
  - `meta` object
    - `first` string, required
    - `previous` string, required
    - `next` string, required
    - `last` string, required

---

[API](https://skmtc.dev/transfeera/apis/recebimentos.md) - [All operations](https://skmtc.dev/transfeera/apis/recebimentos/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/recebimentos/revisions/4dc648d67cb1?raw)