---
title: "Get SIM locations"
method: GET
path: "/devices/locations"
tags: ["SIMs (Devices)"]
---

# Get SIM locations

`GET /devices/locations`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/devices/locations`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/devices/locations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve location information for SIMs (devices) that have reported location data. Returns a paginated list of SIMs with their most recent location including latitude, longitude, and accuracy range.

## Query parameters

- `orgid` integer
- `limit` integer
- `startafter` integer
- `ids` string

## Response `200`

OK

- ListDeviceLocationsResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer: ID of the last record returned, for cursor-based pagination
  - `data` DeviceLocationEntry[]
    - `deviceid` integer: Device ID
    - `name` string: Device name
    - `latitude` union: Approximate latitude (rounded to 3 decimal places, empty string if unavailable)
      - number
      - string
    - `longitude` union: Approximate longitude (rounded to 3 decimal places, empty string if unavailable)
      - number
      - string
    - `range` union: Location accuracy range in meters (empty string if unavailable)
      - number
      - string

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)