Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Expenses > Expense

Reads a single Expense

Reads a single Expense

get/api/2026-07-01/resources/expenses/expenses/{id}

Path parameters

idstring required

The ids of the expenses to filter by

Response

OK

idstring

The id of the expense

employee_idstring

The id of the expense's owner

company_idstring required

The id of the expense's company

card_payment_idstring

The id of the card payment

dispute_idstring

The id of the dispute

expenses_expensable_idstring

The id of the expensable

merchant_namestring

The name of the merchant

user_merchantstring

The merchant name as typed by the employee, when they corrected or filled it manually (takes precedence over the extracted merchant_name)

merchant_tinstring

The tax identification number of the merchant

categoryobject

The category of the expense

subcategorystring

The subcategory of the expense

creation_type'manual' | 'automatic' | 'travelperk' required

How the expense was created, one of 'manual', 'automatic' or 'travelperk'

referencestring

The reference of the expense

amountinteger

The total amount in cents

currencystring required

The currency of the expense

status'pending' | 'changes_requested' | 'approved' | 'paid' | 'rejected' | 'reversed' | 'draft' | 'in_payroll' | 'sent_to_pay' required

The lifecycle status of the expense in the review/payment flow

descriptionstring

The description of the expense

effective_onstring required

The date when the expense was made

review_request_atstring

The date and time when the expense was reviewed

status_updated_atstring required

The date and time when the status was updated

external_authorization_idstring

The id of the external authorization

expenses_card_idstring

The id of the card

cardobject

The card of the expense

document_idstring

The id of the document

signed_documentobject

The signed document of the expense

access_tokenstring

The access token of the expense

paid_atstring

The date and time when the expense was paid

document_numberstring

Number of the financial document associated to the expense

document_typestring

Type of the financial document associated to the expense

payment'reimbursable' | 'not_reimbursable'

The payment of the expense

payment_methodstring

The method of the payment

exchange_ratenumber

The exchange rate of the payment

reimbursable_currencystring

The currency of the reimbursable amount

reimbursable_amountinteger

The optional reimbursable amount in cents

category_idstring

The id of the expense category the expense is classified under (company-configurable catalogue)

ledger_account_idstring

The id of the ledger account

budget_idstring

The id of the budget associated with this expense

project_idstring

The id of the project associated with this expense

cost_center_idsstring[] required

Array of cost center IDs associated with this expense

Example response

{
  "id": "1",
  "employee_id": "1",
  "company_id": "1",
  "card_payment_id": "1",
  "dispute_id": "1",
  "expenses_expensable_id": "1",
  "merchant_name": "Example Merchant",
  "user_merchant": "Example User Merchant",
  "subcategory": "Subcategory",
  "reference": "1414PX",
  "amount": 1000,
  "currency": "EUR",
  "status": "draft",
  "description": "Example Description",
  "effective_on": "2020-01-01",
  "review_request_at": "2020-01-01T00:00:000Z",
  "status_updated_at": "2020-01-01T00:00:000Z",
  "expenses_card_id": "1",
  "document_id": "1",
  "paid_at": "2020-01-01T00:00:000Z",
  "document_type": "invoice",
  "reimbursable_currency": "EUR",
  "reimbursable_amount": 1000,
  "ledger_account_id": "1",
  "budget_id": "1",
  "project_id": "1",
  "cost_center_ids": [
    "1",
    "2"
  ]
}