List fees
Lists the requester's fees, from newest to oldest, with cursor pagination. Without filters, the list returns the fees of every account and the fees charged to the requester itself. To see the fee statement of one account, filter by that account with account_key.
Endpoint
/billing/requester_configuration/invoicesAuthentication
Requires a signed request. See Authentication. The requester is the one whose credential signs the request.
Query params
All parameters are optional.
| Field | Type | Description |
|---|---|---|
start_date | string | Start date of the period, in yyyy-mm-dd format, inclusive. |
end_date | string | End date of the period, in yyyy-mm-dd format, inclusive. Cannot be earlier than start_date. |
status | string | Fee status. status enumerator |
billing_type | string | Fee type. Can be repeated to combine types (billing_type=account_maintenance&billing_type=outgoing_ted). |
payment_method | string | Payment method of the fee. payment_method enumerator |
account_key | uuid | Account key. Returns the fee statement of that account. Can be repeated, up to the value of page_size. When sent, the three account filters below are ignored. |
owner_document_number | string | CPF or CNPJ of the account holder, digits only. Returns the fees of every account of that holder. |
account_number | string | Account number, without the check digit. |
owner_name | string | Beginning of the holder's name. The list returns the fees of the 50 newest accounts whose holder name starts with this value. |
page_size | integer | Number of fees per page. Default 100, minimum 1, maximum 100. |
cursor | string | The cursor value of the previous response, to fetch the next page. Do not send it on the first page. |
Pagination
- Make the first request without
cursor. - If
has_next_pageistrue, repeat the request with the same filters andcursorset to thecursorof the response. - Stop when
has_next_pageisfalse.
Keep the same filters on every page. The cursor is the key of the last fee of the page and is only valid for the requester that made the query.
Response
| Field | Type | Description |
|---|---|---|
data | array | Fees of the page. Data |
requester_name | string | Name of the requester. Filled when the page has a fee charged to the requester (account null); otherwise null. |
page_size | integer | Number of fees per page. |
has_next_page | boolean | true when there is a next page. |
cursor | string | Value to send in cursor to fetch the next page. null on the last page. |
accounts_truncated | boolean | true when the owner_name filter matched more than 50 accounts and the list returned only the fees of the 50 newest. Refine the name to see the others. |
Data
| Field | Type | Description |
|---|---|---|
invoice_key | uuid | Fee key. |
reference_date | string | Fee date, in yyyy-mm-dd format. |
billing_type | string | Fee type. |
billing_type_description | string | Description of the fee type, in Portuguese. |
status | string | Fee status. status enumerator |
total_amount | number | Total amount of the fee. |
paid_amount | number | Amount already paid. |
amount_owed | number | Outstanding amount. 0 for a written-off fee. |
payment_method | string | Payment method of the fee. null when it matches no method. payment_method enumerator |
billing_account_owner_type | string | Who owns the debited account. null when no account is debited or when it is neither of the two in the enumerator. billing_account_owner_type enumerator |
payer_document_number | string | CPF or CNPJ of the bank slip payer. null when the fee is not charged by bank slip. |
account | object | Account that originated the fee. null when the fee is charged to the requester itself. Account |
Account
| Field | Type | Description |
|---|---|---|
account_key | uuid | Account key. |
account_number | string | Account number, without the check digit. |
account_digit | string | Account check digit. |
owner_name | string | Name of the account holder. |
owner_document_number | string | CPF or CNPJ of the account holder. |
{
"data": [
{
"invoice_key": "d1f4a2b6-8c3e-4f5a-9b7d-2e6c8a0f1d3b",
"reference_date": "2026-10-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,
"payment_method": "account_debit",
"billing_account_owner_type": "account_holder",
"payer_document_number": null,
"account": {
"account_key": "5b0e8c1a-3f2d-4e6b-9a7c-1d2e3f4a5b6c",
"account_number": "1234567",
"account_digit": "8",
"owner_name": "Empresa Exemplo Ltda",
"owner_document_number": "96969879000101"
}
},
{
"invoice_key": "b2e5c3a7-9d4f-4a6b-8c1e-3f7d9b1a2c4e",
"reference_date": "2026-09-30",
"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,
"payment_method": "centralizing_account_debit",
"billing_account_owner_type": "centralizing_account",
"payer_document_number": null,
"account": null
}
],
"requester_name": "Requester Exemplo S.A.",
"page_size": 2,
"has_next_page": true,
"cursor": "b2e5c3a7-9d4f-4a6b-8c1e-3f7d9b1a2c4e",
"accounts_truncated": false
}
Errors
| Status | Code | Description |
|---|---|---|
| 400 | BLL000096 | Date not in yyyy-mm-dd format, or end_date earlier than start_date. |
| 400 | BLL000043 | status is not in the enumerator. |
| 400 | BLL000130 | payment_method is not in the enumerator. |
| 400 | BLL000090 | page_size is not an integer. |
| 400 | BLL000091 | page_size lower than 1 or greater than 100. |
| 400 | BLL000132 | cursor is not a fee of the requester. |
| 400 | BLL000133 | More account_key values than the value of page_size. |
| 404 | BLL000111 | One of the billing_type values does not exist. |
| 422 | BLL000129 | The query exceeded the maximum time. Choose a shorter period or filter by account. |
The error body follows the standard format (title, description, translation, code). General platform errors are in the common errors of the BaaS error catalog.
Enumerators
status enumerator
| Value | Description |
|---|---|
open | Open fee. |
pending | Awaiting payment. |
paid | Paid fee. |
written_off | Written-off fee. |
payment_method enumerator
| Value | Description |
|---|---|
account_debit | Debit from the account holder's account. |
centralizing_account_debit | Debit from the requester's centralizing account. |
bank_slip | Charged by bank slip. |
account_debit_and_bank_slip | Part debited from the account, the rest charged by bank slip. |
billing_account_owner_type enumerator
| Value | Description |
|---|---|
account_holder | Account of the holder that originated the fee. |
centralizing_account | Centralizing account of the requester. |
Next step
To download the same fees as a CSV file, use the fee export, which accepts the same filters.