Fee statement

Returns a list of the fees charged to a specific billing account in the selected period.

Request

ENDPOINT

/billing/requester_configuration/billing_account/BILLING_ACCOUNT_KEY/invoices

METHOD

GET

Path Params

Field	Type	Description
BILLING_ACCOUNT_KEY	string	id (uuid) of the billing account whose fees will be listed.

Query Params

Field	Type	Description
start_date	string	Start date of the period, in yyyy-mm-dd format. Optional.
end_date	string	End date of the period, in yyyy-mm-dd format. Optional.
status	string	Filters by fee status. Optional. Status enumerator
billing_type	string	Filters by fee type. Can be provided more than once to combine types. Optional.
page	integer	Page number. Default 1.
page_size	integer	Number of fees per page. Default 20, maximum 50.

Response

STATUS

200

Response Body

{
  "data": [
    {
      "invoice_key": "d1f4a2b6-8c3e-4f5a-9b7d-2e6c8a0f1d3b",
      "reference_date": "2026-06-01",
      "billing_type": "account_maintenance",
      "billing_type_description": "Tarifa de Manutenção de Conta",
      "status": "paid",
      "total_amount": 30.00,
      "paid_amount": 30.00,
      "amount_owed": 0.00
    },
    {
      "invoice_key": "b2e5c3a7-9d4f-4a6b-8c1e-3f7d9b1a2c4e",
      "reference_date": "2026-06-15",
      "billing_type": "outgoing_ted",
      "billing_type_description": "Tarifa de Envio de TED",
      "status": "open",
      "total_amount": 20.00,
      "paid_amount": 0.00,
      "amount_owed": 20.00
    }
  ],
  "page": 1,
  "page_size": 20,
  "has_next_page": false
}

Response Body

Field	Type	Description
data	array	List of charged fees. Data
page	integer	Returned page.
page_size	integer	Number of fees per page.
has_next_page	boolean	Indicates whether there are more pages of results.

Data

Field	Type	Description
invoice_key	string	id (uuid) of the fee.
reference_date	string	Reference date of the fee, in yyyy-mm-dd format.
billing_type	string	Fee type (enumerator).
billing_type_description	string	Description of the fee type.
status	string	Fee status. Status enumerator
total_amount	number	Total amount of the fee.
paid_amount	number	Amount already paid of the fee.
amount_owed	number	Outstanding amount of the fee. Written-off fees (written_off) return 0.

Enumerators

Status enumerator

Enumerator	Description
open	Open fee.
pending	Fee awaiting payment.
paid	Settled fee.
written_off	Written-off fee.

STATUS

4XX

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo"
}

HTTP Code	QI Code code	Title title	Description description	Translation translation
400	BLL000096	Invalid Date Format	Dates must be formatted as 'yyyy-mm-dd'.	Datas devem ser formatadas como 'aaaa-mm-dd'
400	BLL000043	Bad Request	Invalid status enumerator	Status informado não é válido
400	BLL000090	Invalid value for params	Page Size and Page Number must be integers	Page Size e Page Number devem ser números inteiros
400	BLL000091	Page size too large	Requested page size above limit of 50	Tamanho de página requerido acima do limite de 50
400	BLL000063	Bad Request	Not allowed to view fees in unavailable accounts	Conta indisponível.