FAfactorialhr
Expenses > PerDiem

Reads a single Per diem

Changed on

Reads a single Per diem

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

Request

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

The IDs of the per diem to read.

Response

OK

idstring required

The ID of the per diem.

employee_idstring

The ID of the employee the per diem is for.

company_idstring required

The ID of the company the per diem is for.

expenses_expensable_idstring

The ID of the expensable the per diem is for.

end_datestring

The last day of the trip the allowance covers.

start_datestring

The first day of the trip the allowance covers.

fromstring

The location the per diem is from.

tostring

The location the per diem is to.

trip_namestring

The name of the trip.

ledger_account_idstring

The ID of the ledger account the per diem is for.

amountinteger

The total allowance amount in cents.

currencystring required

The currency code in ISO 4217 format.

reimbursable_amountinteger

The amount to be reimbursed by the per diem in cents.

reimbursable_currencystring

The currency for the reimbursable amount.

payment'reimbursable' | 'not_reimbursable' required

The payment method for the per diem.

paid_atstring

The date the per diem was paid.

review_request_atstring

The date the per diem was requested for review.

effective_onstring

The date the per diem is effective on.

descriptionstring

The description of the per diem.

subcategorystring

The subcategory of the per diem.

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

The status of the per diem.

budget_idstring

The id of the budget associated with this per diem

project_idstring

The id of the project associated with this per diem

cost_center_idsstring[] required

Array of cost center IDs associated with this per diem

Example response

{
  "id": "1",
  "employee_id": "1",
  "company_id": "1",
  "expenses_expensable_id": "1",
  "end_date": "2020-01-01",
  "start_date": "2020-01-01",
  "from": "New York",
  "to": "San Francisco",
  "trip_name": "Berlin - Barcelona, 12-19 Mar 2026",
  "ledger_account_id": "1",
  "amount": 1000,
  "currency": "USD",
  "reimbursable_amount": 250,
  "reimbursable_currency": "USD",
  "payment": "reimbursable",
  "paid_at": "2020-01-01T12:00:00.000Z",
  "review_request_at": "2020-01-01T12:00:00.000Z",
  "effective_on": "2020-01-01T12:00:00.000Z",
  "description": "Per diem for trip to San Francisco",
  "subcategory": "national",
  "status": "approved",
  "budget_id": "1",
  "project_id": "1",
  "cost_center_ids": [
    "1",
    "2"
  ]
}

Changes