Expense Query

Retrieve the data and the current status of an expense in the submission flow.

tip

This endpoint returns the status of the expense within the submission process (e.g. created, pending_adm_approval, approved). To query expenses already consolidated in the fund's ledger, use the expense query API.

Request

ENDPOINT

/expense_submission/fund_class/{fund_class_key}/contract/{contract_key}/expense/{expense_key}

METHOD

GET

Path params

Parameter	Type	Description
fund_class_key	string	Unique key of the fund (UUID)
contract_key	string	Unique key of the contract
expense_key	string	Unique key of the expense (UUID)

Response

STATUS

200

Response Body

{
    "expense_key": "7f3e9a1b-2c4d-5e6f-8901-abcdef234567",
    "contract_key": "contrato-auditoria-2026",
    "status": "approved",
    "payment_method": "transfer",
    "start_deferral_date": "2026-06-02",
    "end_deferral_date": "2026-06-30",
    "description": "Honorários de auditoria referente ao 1º semestre de 2026",
    "payment": {
        "target": {
            "name": "AUDITORES EXEMPLO S.A.",
            "document_number": "12.345.678/0001-90"
        },
        "target_account": {
            "account_number": "123456",
            "account_branch": "0001",
            "account_digit": "0",
            "financial_institution_code": "341"
        },
        "transfer_type": "wire_transfer",
        "source_account": {
            "account_key": "5e621ba2-b4ac-4ddd-9893-82d220e1577e"
        }
    },
    "payment_value": 15000.00,
    "payment_date": "2026-07-01",
    "rebate_expense_key": null,
    "fund_class": {
        "name": "FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS EXEMPLO",
        "manager": {
            "name": "EXEMPLO GESTORA LTDA",
            "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
            "document_number": "45.585.471/0001-47"
        },
        "fund_class_key": "4b8377d0-58ec-479f-8ee9-9f963d5c47ad",
        "document_number": "60.910.091/0001-24"
    }
}

Response attributes

Field	Type	Description
expense_key	string	Unique key of the expense (UUID).
contract_key	string	Key of the contract the expense belongs to.
status	string	Current status in the submission flow. See the expense status table.
payment_method	string	Payment method: transfer, automatic_debit or bank_slip.
start_deferral_date	string	Accrual start date in the YYYY-MM-DD format.
end_deferral_date	string	Accrual end date in the YYYY-MM-DD format.
description	string	Expense description.
payment	object	Payment data as registered.
payment_value	number	Expense value.
payment_date	string	Payment date in the YYYY-MM-DD format.
rebate_expense_key	string	Key of the original expense when this is a rebate, or null.
fund_class	object	Data of the associated fund.

Possible errors

STATUS

404

Expense not found

The fund_class_key + contract_key + expense_key set does not correspond to any registered expense.

{
  "title": "Expense Not Found",
  "description": "Expense with key {expense_key} was not found.",
  "translation": "A despesa com chave {expense_key} não foi encontrada.",
  "code": "ESB000016"
}