# Get a marker

`GET` `https://streetartcities.com/api/markers/{markerId}`

Everything about one marker, straight from the database. Markers that were merged into another one give a 404.

## Path parameters

- **markerId** `string` — required

## Requirements

Needs an [access token](/authentication/tokens/). When using OAuth, the token needs the [`markers:read`](/authentication/scopes/) scope.

## Responses

### `200` The marker

- **@type** `string` · const: Marker — required
- **id** `string` — required
- **href** `string` — required
  Link to the marker on Street Art Cities
- **city** `object`
  The city it's in. Missing when it isn't in a city
  - **id** `string` — required
  - **title** `string`
- **country** `string`
  Two-letter country code, like `NL`
- **countryName** `string`
- **lat** `number` — required
- **lng** `number` — required
- **address** `string`
- **type** `string` — required
  Marker type, like `artwork` or `legal_wall`
- **title** `string`
- **status** `string`
  `active`, `inProgress` or `removed`
- **description** `string`
  Can contain simple HTML, like links and line breaks
- **artists** `array object[]` — required
  The artists who made it
  - _Array of object_
    - **id** `string` — required
    - **title** `string` — required
    - **href** `string` — required
- **artistsString** `string` — required
  Names of the artists, comma separated
- **tags** `array string[]` — required
- **thumbnail** `string`
  Link to a small image
- **likes** `number` — required
- **createdAt** `string`
- **updatedAt** `string`
- **images** `array object[]`
  Pictures, the first one is the main one. Not in search results
  - _Array of object_
    - **id** `string`
    - **url** `string` — required
- **attributes** `object`
  Extra details, like the year it was made. Not in search results
  - ***** `any`
- **distance** `number`
  Meters from `lat` and `lng`, when searching by distance. Only in search results

### `401` Not logged in

- **error** `object` — required
  - **message** `string` — required
  - **details** `array any[]`

### `403` The app doesn't have the markers:read scope

- **error** `object` — required
  - **message** `string` — required
  - **details** `array any[]`

### `404` Not found

- **error** `object` — required
  - **message** `string` — required
  - **details** `array any[]`