FAfactorialhr
Expenses > Expensable

Reads a single Expensable

Changed on

Reads a single Expensable

get/api/2026-10-01/resources/expenses/expensables/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/expenses/expensables/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: expenses
    • or API key in header x-api-key

Path parameters

idstring required

Return only the expensables with these ids.

Response

OK

idstring required

Unique identifier for the expensable

type'expense' | 'mileage' | 'perdiem' required

Type of the expensable. Can be either "expense" or "mileage" or "perdiem"

company_idstring required

The ID of the company that owns the expensable

employee_idstring required

The ID of the employee that owns the expensable

group_idstring

The ID of the expense report (group of expensables submitted together) this expensable was submitted in, if any

legal_entity_idstring

The optional ID of the legal entity that the expensable belongs to

created_atstring required

The date and time when the expensable was created

amountinteger

The optional amount in cents

currencystring required

The currency code in ISO 4217 format

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

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

descriptionstring

The optional description of the expensable

reporter_idstring

The optional ID of the employee that reported the expensable

status_updated_atstring required

The optional date and time when the status was last updated

effective_onstring

The optional date and time when the expensable was effective

review_request_atstring

The date and time the expensable was submitted for review. Null while it is a draft; set at submission and never cleared afterwards. Compare it with effective_on to measure how late a document was submitted.

paid_atstring

The optional date and time when the expensable was set as paid

updated_atstring required

The date and time when the expensable was last updated

reimbursable_amountinteger

The optional reimbursable amount in cents

reimbursable_currencystring

The optional reimbursable currency code in ISO 4217 format

reimbursement_method'unknown' | 'sepa_transfer' | 'payroll'

The optional reimbursement method

internal_referencestring

The optional internal reference of the expensable

expense_idstring

The ID of the receipt-backed expense detail record; set only when type is "expense"

mileage_idstring

The ID of the mileage claim detail record; set only when type is "mileage"

per_diem_idstring

The ID of the per-diem allowance detail record; set only when type is "perdiem"

budget_idstring

The ID of the budget this expensable draws from, when one is linked

project_idstring

The ID of the project this expensable is charged to, when one is linked

cost_center_idsstring[] required

The IDs of the cost centers the expensable's cost is allocated to

Example response

{
  "id": "1",
  "type": "expense",
  "company_id": "1",
  "employee_id": "1",
  "group_id": "1",
  "legal_entity_id": "1",
  "created_at": "2024-06-06T12:00:00.000Z",
  "amount": 1000,
  "currency": "EUR",
  "status": "approved",
  "description": "Dinner with clients",
  "reporter_id": "1",
  "status_updated_at": "2024-06-06T12:00:00.000Z",
  "effective_on": "2024-06-06T12:00:00.000Z",
  "review_request_at": "2024-06-06T12:00:00.000Z",
  "paid_at": "2024-06-06T12:00:00.000Z",
  "updated_at": "2024-06-06T12:00:00.000Z",
  "reimbursable_amount": 1000,
  "reimbursable_currency": "EUR",
  "reimbursement_method": "sepa_transfer",
  "internal_reference": "REF123",
  "expense_id": "1",
  "mileage_id": "1",
  "per_diem_id": "1",
  "budget_id": "1",
  "project_id": "1",
  "cost_center_ids": [
    "1",
    "2"
  ]
}

Changes