---
title: "Reads all Per diems"
method: GET
path: "/api/2026-10-01/resources/expenses/per_diems"
tags: ["Expenses > PerDiem"]
---

# Reads all Per diems

`GET /api/2026-10-01/resources/expenses/per_diems`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/expenses/per_diems`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `expenses`
  - API key in header `x-api-key`

Reads all Per diems

## Query parameters

- `ids[]` string[]: The IDs of the per diem to read.
- `expenses_expensable_ids[]` string[]: The IDs of the expensables to read per diems for.
- `exclude_drafts` boolean: Whether to exclude drafts from the results.

## Response `200`

OK

- object
  - `data` ExpensesPerDiem[]
    - `id` string, required: The ID of the per diem.
    - `employee_id` string: The ID of the employee the per diem is for.
    - `company_id` string, required: The ID of the company the per diem is for.
    - `expenses_expensable_id` string: The ID of the expensable the per diem is for.
    - `end_date` string: The last day of the trip the allowance covers.
    - `start_date` string: The first day of the trip the allowance covers.
    - `from` string: The location the per diem is from.
    - `to` string: The location the per diem is to.
    - `trip_name` string: The name of the trip.
    - `ledger_account_id` string: The ID of the ledger account the per diem is for.
    - `amount` integer: The total allowance amount in cents.
    - `currency` string, required: The currency code in ISO 4217 format.
    - `reimbursable_amount` integer: The amount to be reimbursed by the per diem in cents.
    - `reimbursable_currency` string: The currency for the reimbursable amount.
    - `payment` 'reimbursable' | 'not_reimbursable', required: The payment method for the per diem.
    - `paid_at` string: The date the per diem was paid.
    - `files` object[], required: The files attached to the per diem.
      - `id` string, required
      - `filename` string, required
      - `url` string
      - `download_url` string
      - `byte_size` integer, required
      - `content_type` string
    - `review_request_at` string: The date the per diem was requested for review.
    - `effective_on` string: The date the per diem is effective on.
    - `description` string: The description of the per diem.
    - `category` object: The category of the per diem.
      - `id` string, required
      - `name` string, required
    - `subcategory` string: 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_id` string: The id of the budget associated with this per diem
    - `project_id` string: The id of the project associated with this per diem
    - `cost_center_ids` string[], required: Array of cost center IDs associated with this per diem
    - `rates` object[], required: The rates for the per diem.
      - `id` string
      - `expenses_per_diem_id` string, required
      - `rate_configuration_id` string, required
      - `total_days` integer
      - `total_amount_cents` integer
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/expenses/per_diems/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)
