Consolidated expense query

Endpoints to query the expenses of a fund class. There are two query modes: the paginated listing of all the expenses of a fund class, and the individual query of a specific expense.

When to use

Use these endpoints to track the status of the registered expenses, check provisioned and consolidated values, and query the payment data of each expense.

Expense listing

Returns the paginated list of all the expenses of a fund class, with support for several filters.

Request

ENDPOINT

/expense/fund_class/{fund_class_key}/expenses

METHOD

GET

Query params

Parameter	Type	Required	Description
`page`	integer	optional	Page number (starts at 0). Default: `0`.
`limit`	integer	optional	Number of records per page. Minimum: `0`. Maximum: `100`. Default: `10`.
`reference_date`	string	optional	Filters expenses by the exact reference date, in the `YYYY-MM-DD` format.
`from_end_deferral_date`	string	optional	Filters expenses with a deferral end date greater than or equal to the provided date, in the `YYYY-MM-DD` format.
`to_end_deferral_date`	string	optional	Filters expenses with a deferral end date less than or equal to the provided date, in the `YYYY-MM-DD` format.
`status`	string	optional	Filters by the expense status. Accepts multiple comma-separated values (e.g. `paid,consolidated`). See `status` enumerators.
`expense_type`	string	optional	Filters by the expense type. Accepts multiple comma-separated values (e.g. `management_tax,custody_tax`). See `type` enumerators.
`expense_status_to_ignore`	string	optional	Excludes expenses with the provided status from the listing.
`expense_type_to_ignore`	string	optional	Excludes expenses with the provided type from the listing.
`ignore_paid_on_future`	boolean	optional	When `true`, excludes expenses that have already been paid but whose confirmation date is later than the reference date.

Example call
GET /expense/fund_class/{fund_class_key}/expenses?page=0&limit=10&status=consolidated,paid

Response

STATUS

200

Response Body
{
    "data": [
        {
            "expense_key": "3571e292-3a83-4011-904d-20ee963022ef",
            "fund_class": {
                "name": "Fundo de Investimento XYZ",
                "manager": {
                    "name": "Gestora ABC",
                    "manager_key": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
                    "document_number": "12.345.678/0001-90"
                },
                "fund_class_key": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
                "document_number": "98.765.432/0001-10",
                "accounting_date": "2025-06-10"
            },
            "status": "consolidated",
            "type": "management_tax",
            "reference_date": "2025-06-10",
            "start_deferral_date": "2025-06-01",
            "end_deferral_date": "2025-06-30",
            "consolidated_value": 1500.00,
            "provisioned_value": 1500.00,
            "recognized_value": 1500.00,
            "payment": null,
            "expense_datetime": "2025-06-01T00:00:00Z",
            "description": "Taxa de gestão referente ao mês de junho/2025",
            "payment_method": "transfer",
            "payment_date": "2025-06-30",
            "payment_confirmation": {
                "confirmation_date": "2025-06-30"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Response attributes

Field	Type	Description
`data`	array	List of expense objects. See Attributes of each expense.
`page`	integer	Current page number.
`limit`	integer	Number of records per page.
`is_last_page`	boolean	Indicates whether this is the last page of results.

Attributes of each expense (objects inside `data`)

Field	Type	Description
`expense_key`	string	Unique identifier of the expense (UUID).
`fund_class`	object	Data of the fund class the expense belongs to. See `fund_class` attributes.
`status`	string	Current status of the expense. See `status` enumerators.
`type`	string	Expense type. See `type` enumerators.
`reference_date`	string	Reference date of the expense in the `YYYY-MM-DD` format.
`start_deferral_date`	string	Deferral start date in the `YYYY-MM-DD` format.
`end_deferral_date`	string	Deferral end date in the `YYYY-MM-DD` format.
`consolidated_value`	number	Consolidated value of the expense. May be `null` when the expense has not been consolidated yet.
`provisioned_value`	number	Provisioned value of the expense. May be `null` when there is no provision yet.
`recognized_value`	number	Recognized value of the expense.
`payment`	object	Payment data associated with the expense. May be `null` when there is no linked payment.
`expense_datetime`	string	Date and time the expense was created, in the ISO 8601 format (e.g. `2025-06-01T00:00:00Z`).
`description`	string	Textual description of the expense.
`payment_method`	string	Payment method of the expense. See `payment_method` enumerators.
`payment_date`	string	Payment date in the `YYYY-MM-DD` format. Present only when the expense has a defined payment date.
`payment_confirmation`	object	Payment confirmation data. Present only when the payment has been confirmed. See `payment_confirmation` attributes.

`fund_class` attributes

Field	Type	Description
`name`	string	Name of the fund class.
`fund_class_key`	string	Unique identifier of the fund class (UUID).
`document_number`	string	CNPJ of the fund class.
`accounting_date`	string	Accounting date of the fund class in the `YYYY-MM-DD` format.
`manager`	object	Data of the responsible manager. See `manager` attributes.

`manager` attributes

Field	Type	Description
`name`	string	Manager name.
`manager_key`	string	Unique identifier of the manager (UUID).
`document_number`	string	Manager's CNPJ.

`payment_confirmation` attributes

Field	Type	Description
`confirmation_date`	string	Payment confirmation date in the `YYYY-MM-DD` format.

Specific expense query

Returns the complete data of a specific expense of a fund class.

Request

ENDPOINT

/expense/fund_class/{fund_class_key}/expense/{expense_key}

METHOD

GET

Path params

Parameter	Type	Description
`fund_class_key`	string	Unique identifier (UUID) of the fund class the expense belongs to.
`expense_key`	string	Unique identifier (UUID) of the expense to be queried.

Example call
GET /expense/fund_class/{fund_class_key}/expense/{expense_key}

Response

STATUS

200

Response Body
{
    "expense_key": "3571e292-3a83-4011-904d-20ee963022ef",
    "fund_class": {
        "name": "Fundo de Investimento XYZ",
        "manager": {
            "name": "Gestora ABC",
            "manager_key": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
            "document_number": "12.345.678/0001-90"
        },
        "fund_class_key": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
        "document_number": "98.765.432/0001-10",
        "accounting_date": "2025-06-10"
    },
    "status": "consolidated",
    "type": "management_tax",
    "reference_date": "2025-06-10",
    "start_deferral_date": "2025-06-01",
    "end_deferral_date": "2025-06-30",
    "consolidated_value": 1500.00,
    "provisioned_value": 1500.00,
    "recognized_value": 1500.00,
    "payment": null,
    "expense_datetime": "2025-06-01T00:00:00Z",
    "description": "Taxa de gestão referente ao mês de junho/2025",
    "payment_method": "transfer",
    "payment_date": "2025-06-30",
    "payment_confirmation": {
        "confirmation_date": "2025-06-30"
    }
}

Response attributes

The response has the same structure as each object of the data array returned by the expense listing.

Possible errors

STATUS

404

Expense not found

The provided expense_key does not correspond to any expense registered for this fund class. Check that the identifiers are correct.

{
  "title": "Expense not Found",
  "description": "The Expense with key {expense_key} was not found in Fund Class with key {fund_class_key}.",
  "translation": "A Despesa com a chave {expense_key} nao foi encontrada na classe de fundos com a chave {fund_class_key}.",
  "code": "EXP000010"
}

`status` enumerators

Value	Description
`created`	Expense created, the provisioning process has not started yet.
`in_provision`	Expense in the daily provisioning process.
`on_demand_recognition`	Expense with on-demand (manual) recognition.
`consolidated`	Consolidated expense — total value recognized and ready for payment.
`paid`	Expense paid.
`canceled`	Expense canceled.
`completed`	Expense closed.

`type` enumerators

Value	Description
`administration_tax`	Administration fee.
`management_tax`	Management fee.
`performance_fee`	Performance fee.
`custody_tax`	Custody fee.
`distribution_fee`	Distribution fee.
`consulting_fee`	Consulting fee.
`audit_tax`	Audit fee.
`cvm_tax`	CVM fee.
`cetip_tax`	CETIP fee.
`anbima_tax`	ANBIMA fee.
`selic_tax`	SELIC fee.
`notary`	Notary.
`bank_account`	Bank account.
`bankslip_fee`	Bankslip fee.
`sale_commission_tax`	Sales commission fee.
`certifier_fee`	Certifier fee.
`rating_agency_fee`	Rating agency fee.
`lawyer_fee`	Legal fees.
`bookkeeping_fee`	Bookkeeping fee.
`insurance_fee`	Insurance fee.
`collection_agent_fee`	Collection agent fee.
`servicing_fee`	Servicing fee.
`fund_structuring_fee`	Fund structuring fee.
`credit_rights_registration_fee`	Credit rights registration fee.
`origination_fee`	Origination fee.

`payment_method` enumerators

Value	Description
`transfer`	Bank transfer.
`automatic_debit`	Automatic debit.
`bank_slip`	Bankslip.

Expense listing​

Request​

Query params​

Response​

Response attributes​

Attributes of each expense (objects inside data)​

fund_class attributes​

manager attributes​

payment_confirmation attributes​

Specific expense query​

Request​

Path params​

Response​

Response attributes​

Possible errors​

status enumerators​

type enumerators​

payment_method enumerators​

Expense listing

Request

Query params

Response

Response attributes

Attributes of each expense (objects inside `data`)

`fund_class` attributes

`manager` attributes

`payment_confirmation` attributes

Specific expense query

Request

Path params

Response

Response attributes

Possible errors

`status` enumerators

`type` enumerators

`payment_method` enumerators