---
title: "List maps"
method: GET
path: "/api/v1/maps"
tags: ["Maps"]
---

# List maps

`GET /api/v1/maps`

## Request

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

This endpoint returns all maps in the account. You can expand the results to include layer details with `expand["layer"]`. Results paginated.

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

## Query parameters

- `expand[]` string

## Response `200`

Success: Returns all maps in account. Results paginated.

- object
  - `object` string, required
  - `data` object[], required
    - `object` string, required
    - `id` string, uuid, required
    - `title` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `pages` object, required
    - `object` string, required
    - `total_pages` number, required
    - `current_page` number, required
    - `next_page` number, nullable
    - `prev_page` number, nullable
  - `total_count` integer, required

## Other responses

- `401`: Unauthorized: Invalid API Key or does not have the correct permission to access resource.

---

[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)