---
title: "List Location Entries"
method: GET
path: "/vehicles/{id}/location_entries"
tags: ["Location Entries"]
---

# List Location Entries

`GET /vehicles/{id}/location_entries`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/vehicles/{id}/location_entries`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/vehicles/:id/location_entries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of your Location Entries.

## Path parameters

- `id` string, required

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `contact_id` EqFilter
    - `eq` string, required
  - `locatable_id` EqFilter
    - `eq` string, required
  - `locatable_type` EqFilter
    - `eq` string, required
  - `created_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `updated_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
- `sort` object
  - `id` 'asc' | 'desc'
  - `created_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` union[]: The filters applied to the returned record set.
    - union
      - object
        - `contact_id` EqFilter
          - `eq` string, required
      - object
        - `locatable_id` EqFilter
          - `eq` string, required
      - object
        - `locatable_type` EqFilter
          - `eq` string, required
      - object
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `updated_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` LocationEntry[]
    - `id` integer
    - `created_at` string, date-time: The date and time at which this record was created.
    - `updated_at` string, date-time: The date and time at which this record was most recently updated.
    - `date` string, date-time, required: The date and time at which this Location Entry was recorded.
    - `vehicle_id` integer
    - `item_type` 'Vehicle' | 'Equipment', required: The type of object that this Location Entry is associated with.
    - `item_id` integer, nullable, required
    - `locatable_type` 'FuelEntry' | 'ServiceEntry' | 'SubmittedInspectionForm', nullable, required: The type of object that triggered the creation of this Location Entry, if applicable.
    - `locatable_id` integer, nullable, required
    - `contact_id` integer, nullable, required
    - `address` string, nullable, required: The full address where this Location Entry took place.
    - `address_components` AddressComponents, nullable, required
      - `street_number` string: The street number in the address.
      - `street` string: The street name in the address.
      - `city` string: The city in the address.
      - `region` string: The region, state or province in the address.
      - `region_short` string: The abbreviated region, state or province code.
      - `country` string: The country in the address.
      - `country_short` string: The abbreviated country code.
      - `postal_code` string: The postal code, ZIP, or equivalent in the address.
    - `is_current` boolean, required: Indicates whether this Location Entry is the most recent one for this object.
    - `location` string, required: A string representation of the recorded location.
    - `geolocation` object, required: The coordinates of the recorded location.
      - `latitude` number
      - `longitude` number

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `404`: The requested resource could not be located
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 1 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/vehicles/:id/location_entries/get.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)