---
title: "Retrieve a location"
method: GET
path: "/api/v1/locations/{id}"
tags: ["Locations"]
---

# Retrieve a location

`GET /api/v1/locations/{id}`

## Request

- Base URL: `https://api.mapulus.com`
- URL: `https://api.mapulus.com/api/v1/locations/{id}`
- Auth: HTTP bearer

This endpoint returns a single location on a map when provided a valid location id.
        Example Request:

```
curl --location 'https://api.mapulus.com/api/v1/locations/<location-id>' \
--header 'Authorization: Bearer <your-token>' \

## Path parameters

- `id` string, required

## Response `200`

Success: Returns single location.

- object
  - `object` string, required
  - `id` string, uuid, required
  - `lat` number, float, nullable, required
  - `lon` number, float, nullable, required
  - `label` string, nullable
  - `title` string, nullable
  - `address` string, nullable
  - `external_id` string, nullable
  - `geocoding_error` boolean, nullable
  - `geocoding_error_type` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `travel_contour` boolean, nullable
  - `contour_mode` string, nullable
  - `contour_metric` string, nullable
  - `contour_style` string, nullable
  - `contour_minutes` string, nullable
  - `map_id` string, uuid, required
  - `layer_id` string, uuid, required
  - `custom_attributes` object[], required
    - `object` string, required
    - `name` string, required
    - `value` string, nullable, required
    - `custom_attribute_id` string, uuid, required
    - `custom_attribute_value_id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401`: Unauthorized: Invalid API Key or does not have the correct perimission to access resource.
- `404`: RecordNotFound: Location not found in account.

---

[API](https://skmtc.dev/mapulus/apis/mapulus-api.md) · [All operations](https://skmtc.dev/mapulus/apis/mapulus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapulus/apis/mapulus-api/revisions/b99766fa053f?raw)