---
title: "Reads all Mileages"
method: GET
path: "/api/2026-10-01/resources/expenses/mileages"
tags: ["Expenses > Mileage"]
---

# Reads all Mileages

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

## Request

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

## Query parameters

- `ids[]` string[]: Return only the mileage records with these ids.
- `expenses_expensable_ids[]` string[]: Return only the mileage records attached to these expensables. A mileage record is the detail record of an expensable, so this is the usual way to reach it from the header.
- `include_manual_drafts` boolean, required
- `employee_ids[]` string[]: Return only the mileage records of these employees.
- `external_authorization_ids[]` string[]
- `card_ids[]` string[]: Return only the mileage records paid with these cards.
- `card_payment_ids[]` string[]: Return only the mileage records raised from these card payments.
- `include_attachments` boolean, required
- `from` string: Start of the window of travel dates (`effective_on`) to return, inclusive. It only takes effect together with `to`: given on its own it is ignored.
- `to` string: End of the window of travel dates (`effective_on`) to return, exclusive. It only takes effect together with `from`.
- `dispute_ids[]` string[]: Return only the mileage records under these payment disputes.

## Response `200`

OK

- object
  - `data` ExpensesMileage[]
    - `id` string, required: Unique identifier for the mileage
    - `employee_id` string: The ID of the employee that owns the mileage
    - `company_id` string, required: The ID of the company that owns the mileage
    - `expenses_expensable_id` string: The ID of the expensable associated with this mileage
    - `category` object: The category of the mileage
      - `id` string, required
      - `name` string, required
    - `subcategory` string: The subcategory of the mileage
    - `category_id` string: The ID of the category
    - `amount` integer: The amount in cents
    - `currency` string, required: The currency code in ISO 4217 format
    - `reimbursable_amount` integer: The amount to be reimbursed for the mileage in cents.
    - `reimbursable_currency` string: The currency for the reimbursable amount.
    - `status` string, required: The status of the mileage
    - `mileage` integer: The distance travelled, expressed in `units`
    - `units` string: The distance unit `mileage` is expressed in (e.g. km)
    - `rate` string: The reimbursement rate per distance unit, in `currency`
    - `rate_measurement_unit` string: The distance unit the `rate` is denominated in (e.g. mi). The distance is converted into this unit before the rate is applied.
    - `from` string: The origin location
    - `to` string: The destination location
    - `description` string: The description of the mileage
    - `effective_on` string: The date when the mileage was effective
    - `review_request_at` string: The date when the mileage was requested for review
    - `files` object[], required: The files associated with the mileage
      - `id` string, required
      - `filename` string, required
      - `url` string
      - `download_url` string
      - `byte_size` integer, required
      - `content_type` string
    - `paid_at` string: The date when the mileage was paid
    - `payment` 'reimbursable' | 'not_reimbursable', required: The payment method
    - `ledger_account_id` string: The ID of the ledger account
    - `round_trip` boolean: Indicates if the mileage is a round trip
    - `origin_longitude` string: The longitude of the origin of the mileage
    - `origin_latitude` string: The latitude of the origin of the mileage
    - `destination_longitude` string: The longitude of the destination of the mileage
    - `destination_latitude` string: The latitude of the destination of the mileage
    - `calculated_mileage` integer: The calculated mileage between origin and destination in decameters/10-milers
    - `budget_id` string: The id of the budget associated with this mileage
    - `project_id` string: The id of the project associated with this mileage
    - `cost_center_ids` string[], required: Array of cost center IDs associated with this mileage
  - `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/mileages/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)