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

# Listar cobranças

`GET /charges`

## 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' — 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.net/transfeera/apis/autentica-o.md) · [All operations](https://skmtc.net/transfeera/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfeera/autentica-o/revisions/cf24b926bbaa/schema)