---
title: "Read an entity by its id"
method: GET
path: "/entities/{entityId}"
tags: ["discovery"]
---

# Read an entity by its id

`GET /entities/{entityId}`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/entities/{entityId}`
- Auth: HTTP bearer

Retrieves an entity from the current dataset using the source reference encoded in its ID.

When to use: Retrieve the name, center, and bounding box associated with an entity ID.

## Path parameters

- `entityId` string, required

## Response `200`

Read an entity by its id

- object
  - `schema` string
  - `entity` object

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

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