---
title: "Fetch map information list."
method: GET
path: "/beacon_map/fetch"
tags: ["Tracking|Beacon Map Embedding"]
---

# Fetch map information list.

`GET /beacon_map/fetch`

This endpoint enables you to retrieve the present and previous locations of beacons. It will provide the data
utilized by the embedded map. The autoRefresh duration is a parameter utilized for the map view. It is not
significant for your application. It's not recommended to regularly fetch the current position, both to safe
resources and avoid hitting API rate limits.

## Query parameters

- `beacons[byIds][]` integer[]
- `beacons[byUuids][]` string[]
- `beacons[byToolIds][]` string[]
- `estimated_position` boolean

## Response `200`

Success Response:

- StandardBeaconMapFetchResponse
  - `beacons` object[] — The beacons.
    - `id` integer — The internal ID.
    - `uuid` string — The beacon UUID as hexadecimal value.
    - `macAddress` string — The beacon MAC address.
    - `name` string — The name of the beacon. (max. 255 characters)
    - `objectIdentifier` string — External, customer specific ID of the object the beacon is attached to. (max. 64 characters)
    - `objectSerialNumber` string — Serial number of object, the beacon is attached to. (max. 128 characters)
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `lastSignalAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `lastTracker` BeaconMapFetchResponseTrackerItem
      - `id` integer — The internal vehicle ID.
      - `identifier` string — The customer-specific ID. (max. 64 characters)
      - `inventoryNumber` string — The inventory number. (max. 128 characters)
      - `licenseNumber` string — The vehicle license plate. (max. 255 characters)
      - `identificationNumber` string — The vehicle identification number. (max. 24 characters)
      - `importSource` string — External data source from which this vehicle originates. (max. 64 characters)
      - `importKey` string — External ID from the respective data source. (max. 64 characters)
      - `name` string — The vehicle name. (max. 255 characters)
    - `iconUrl` string — The URL for the icon.
  - `autoRefresh` integer — The configured refresh interval in seconds.

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)