FAfactorialhr
Expenses > Expensable

Reads all Expensables

Changed on

Reads all Expensables

get/api/2026-10-01/resources/expenses/expensables

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/expenses/expensables
  • 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

Query parameters

ids[]string[]

Return only the expensables with these ids.

company_idstring
group_ids[]string[]

Return only the expensables filed inside these expense groups, the report or trip bundles an employee submits several expensables in.

by_resources[]object[]
employee_ids[]string[]

Return only the expensables whose spending employee is one of these. When reporter_ids is given too the two are OR'ed, not intersected: the result holds the expensables owned by these employees plus the ones submitted by those reporters.

reporter_ids[]string[]

Return only the expensables submitted by these employees on somebody else's behalf, such as an assistant or an office manager. OR'ed with employee_ids when both are given.

status[]string[]

Return only the expensables in these states: draft, pending, changes_requested, approved, rejected, reversed, in_payroll, sent_to_pay or paid.

creation_type[]string[]

Return only the expensables created this way: manual (entered by a person) or automatic (raised from a card transaction). Those are the only two values the filter understands, and any other string makes the read return nothing at all rather than ignoring the filter.

fromstring

Start of the window of expense dates (effective_on) to return, inclusive. It only takes effect together with to: given on its own it is ignored and no date narrowing happens.

tostring

End of the window of expense dates (effective_on) to return, inclusive. It only takes effect together with from.

searchstring
include_groupedboolean required
include_attachmentsboolean required
include_manual_draftsboolean required

Response

OK

Example response

{
  "data": [
    {
      "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