Expense retrieval

Lists the expenses of a fund or of all of the manager's funds. The list returns every expense of the fund: those created by the manager or consultant, including those still under analysis, and those calculated by QI Tech. For the consultant, it returns only those created by agents (expense_contract, expense, reimbursement and rebate_fee).

• Statuses and origins: Expense lifecycle.
• A single expense by key, with documents and history: Expense retrieval by key.

List the fund's expenses

Available on

Profile	Host	Required permission
Manager	manager-api	Read
Consultant	consultant-api	Read Expenses or Read Consolidations

Base URL for each host: Environments (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expenses

METHOD

GET

Path parameters

Parameter	Type	Description
fund_class_key	string	Fund class key (UUID).

Query parameters

All optional. Parameters marked as list accept multiple comma-separated values.

Parameter	Type	Description
page	integer	Page, starting at 0. Default: 0.
limit	integer	Items per page, from 0 to 100. Default: 10.
status	list	Expense status. An unknown value does not raise an error; it just finds nothing.
expense_status_to_ignore	string	Excludes a status.
expense_type	list	Expense types.
expense_type_to_ignore	list	Excludes expense types.
origin_type	list	Expense origins.
exclude_origin_type	list	Excludes origins. Use rebate_fee to hide rebates.
reference_date	string	Exact reference date, YYYY-MM-DD.
from_end_deferral_date	string	end_deferral_date from this date on, YYYY-MM-DD.
to_end_deferral_date	string	end_deferral_date up to this date, YYYY-MM-DD.
payment_date_start	string	Payment date from this date on, YYYY-MM-DD.
payment_date_end	string	Payment date up to this date, YYYY-MM-DD. Cannot be earlier than payment_date_start.
ignore_paid_on_future	boolean	true excludes expenses whose payment was confirmed after the reference date.
contract_key	string	Expenses of a contract.
vendor_key	string	Expenses of the contract's vendor.
recipient_name	string	Part of the name of the contract's vendor or of the payment's payee.
recipient_document	string	Part of the CPF or CNPJ of the vendor or payee, with or without punctuation.
rebated_expense_key	string	Rebates of a management fee.
created_by_agent_type	string	manager or consultant: who created the expense.
permission_type	string	owner or viewer: the requester's permission over the expense. Returns only expenses posted by the manager or consultant.
description	string	Part of the description.
kpi	string	Indicator: in_analysis, in_provision or pending_invoice. Excludes canceled expenses and rebates.
days	integer	kpi period, counting today: 1, 7 or 30.

The list goes from the most recent expense to the oldest.

Example call

GET /expense/fund_class/{fund_class_key}/expenses?status=consolidated,paid&exclude_origin_type=rebate_fee&limit=50

Response

STATUS

200

Response body

{
    "data": [
        {
            "expense_key": "b7f1c8e2-5a7d-4c7f-9a0e-2c3d4e5f6a7b",
            "fund_class": {
                "name": "FIDC EXEMPLO",
                "manager": {
                    "name": "EXEMPLO GESTORA LTDA",
                    "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
                    "document_number": "22.333.444/0001-81"
                },
                "fund_class_key": "c1d2e3f4-a5b6-4789-abcd-ef1234567890",
                "document_number": "33.444.555/0001-81",
                "accounting_date": "2026-11-06"
            },
            "status": "consolidated",
            "type": "audit_tax",
            "origin": {
                "origin_type": "expense_contract",
                "origin_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
            },
            "payment_value": 15000.0,
            "created_by": {
                "agent_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
                "agent_type": "manager",
                "name": "EXEMPLO GESTORA LTDA"
            },
            "reference_date": "2026-11-06",
            "start_deferral_date": null,
            "end_deferral_date": null,
            "consolidated_value": 15000.0,
            "provisioned_value": null,
            "recognized_value": 15000.0,
            "payment": {
                "target": {
                    "name": "AUDITORES EXEMPLO S.A.",
                    "document_number": "44.555.666/0001-81"
                },
                "target_account": {
                    "account_number": "123456",
                    "account_branch": "0001",
                    "account_digit": "7",
                    "financial_institution_code": "341",
                    "financial_institution_ispb": "60701190"
                }
            },
            "expense_datetime": "2026-11-03T14:03:21Z",
            "last_updated": "2026-11-06T10:15:40Z",
            "description": "Auditoria do exercício 2026",
            "payment_method": "transfer",
            "payment_date": "2026-11-20",
            "consolidation_analysis": {
                "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
                "analysis_number": 1,
                "status": "approved"
            },
            "contract": {
                "contract_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
                "name": "Auditoria 2026",
                "status": "active",
                "vendor": {
                    "vendor_key": "5d2e7b9a-3c4f-4e8a-b1d6-9f0a2c3e4b57",
                    "name": "AUDITORES EXEMPLO S.A."
                }
            },
            "rebate": false,
            "rebated_expense_key": null,
            "permission_type": "owner"
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Attributes of each expense

Field	Type	Description
expense_key	string	Expense key (UUID).
fund_class	object	Fund class: name, fund_class_key, document_number, accounting_date (current accounting date, YYYY-MM-DD) and manager (name, manager_key, document_number).
status	string	Expense status. See status.
type	string	Expense type. See types.
origin	object	origin_type and origin_key. See origin.
payment_value	number	Amount to pay, or null.
created_by	object	Who created it: agent_key, agent_type (manager or consultant), name. null for expenses calculated by QI Tech.
reference_date	string	Date the expense entered the portfolio, YYYY-MM-DD, or null while it is in the submission step.
start_deferral_date	string	Provision start, YYYY-MM-DD, or null.
end_deferral_date	string	Provision end, YYYY-MM-DD, or null.
consolidated_value	number	Consolidated amount, or null.
provisioned_value	number	Provisioned amount, or null.
recognized_value	number	Amount already recognized in the portfolio.
payment	object	Payment details: target (name, document_number) and, depending on the payment method, target_account, target_pix_key, pix_qrcode, bank_slip, source_account, vendor_bank_account_key, conciliation_metadata. May be empty ({}).
expense_datetime	string	Creation, ISO 8601 in UTC (2026-11-03T14:03:21Z).
last_updated	string	Last change to the expense or the analysis, ISO 8601 in UTC.
description	string	Description.
payment_method	string	transfer, pix, bank_slip or automatic_debit, or null.
payment_date	string	Payment date, YYYY-MM-DD. Present only when set.
payment_confirmation	object	confirmation_date (YYYY-MM-DD). Present only after payment.
consolidation_analysis	object	Current consolidation analysis: consolidation_analysis_key, analysis_number, status. See consolidation analysis.
contract	object	The expense's contract: contract_key, name, status, vendor (vendor_key, name). null without a contract.
rebate	boolean	true when the expense is a management fee rebate.
rebated_expense_key	string	Management fee of the rebate, or null.
permission_type	string	owner when the requester created the expense; viewer when another agent created it (for the manager, the consultant). null for expenses calculated by QI Tech.
gross_provisioned_value	number	Only on management_tax: the fee's provisioned amount, which rebates do not reduce (0 without a provisioned amount).
approved_rebate_value	number	Only on management_tax: sum of the rebates with an approved analysis.

List expenses across all funds

Lists the expenses of all of the manager's funds, with the same response as the fund list.

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

ENDPOINT

/expense/expenses

METHOD

GET

It accepts the same filters as the fund list, except reference_date, from_end_deferral_date, to_end_deferral_date and ignore_paid_on_future, which are ignored. It has two extra parameters:

Parameter	Type	Description
fund_class_key	string	Restricts the result to those funds. Repeatable: fund_class_key=...&fund_class_key=....
payment_date	string	Exact payment date, YYYY-MM-DD.

Example call

GET /expense/expenses?fund_class_key={fund_class_key_1}&fund_class_key={fund_class_key_2}&payment_date=2026-11-20

Errors

Status	code	When it happens
400	EXP000069	The fund class does not belong to the manager.
400	EXP000186	created_by_agent_type, permission_type or kpi with a value outside the list, or payment_date_end earlier than payment_date_start.
400	EXP000185	days other than 1, 7 and 30 (kpi filter).
404	EXP000018	List across all funds: the manager has no funds in the expense service.
500	QIT000500	limit or page out of range, a date not in the YYYY-MM-DD format, or an invalid boolean (ignore_paid_on_future). Validation of these parameters comes back as an internal error: fix the parameter and retry the call.

Example

{
  "title": "Manager Not Associated with Fund Class",
  "description": "Manager with key a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c is not associated with Fund Class with key c1d2e3f4-a5b6-4789-abcd-ef1234567890.",
  "translation": "Gestor com chave a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c nao esta associado com Fundo com chave c1d2e3f4-a5b6-4789-abcd-ef1234567890.",
  "code": "EXP000069"
}

Authentication, permission and host errors: see API Errors.