---
title: "Retrieve a map"
method: GET
path: "/api/v1/maps/{id}"
tags: ["Maps"]
---

# Retrieve a map

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

## Request

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

This endpoint returns a single locations on a map when provided a valid map id. You can expand the results to include layer details with `expand["layer"]`.

Example request:
```
curl --location --request GET 'https://api.mapulus.com/api/v1/maps/<map-id>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your-token>' \
--data '{
          "expand": ["layer"]
        }'
}'

## Path parameters

- `id` string, required

## Query parameters

- `expand[]` string

## Response `200`

Succcess: Returns map

- object
  - `object` string, required
  - `id` string, uuid, required
  - `title` string, 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 permission 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)