# Get an artist

`GET` `https://streetartcities.com/api/artists/{artistId}`

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

## Path parameters

- **artistId** `string` — required

## Requirements

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

## Responses

### `200` The artist

- **@type** `string` · const: Artist — required
- **id** `string` — required
- **title** `string` — required
- **href** `string` — required
  Link to the artist on Street Art Cities
- **alternativeTitles** `array string[]` — required
  Other names they go by, and other ways to spell their name
- **logoImage** `string`
  Link to their profile picture
- **country** `string`
  Where they're based
- **artworksCount** `number` — required
  How many of their artworks are on the map
- **createdAt** `string`
- **updatedAt** `string`
- **bio** `string`
- **headerImage** `string`
- **socialLinks** `array object[]`
  Links to their website and social media
  - _Array of object_
    - **type** `string` — required
    - **url** `string` — required
- **homeTown** `object`
  - **label** `string` — required
  - **country** `string`
- **currentTown** `object`
  - **label** `string` — required
  - **country** `string`
- **claimed** `boolean`
  Whether the artist looks after this profile themselves
- **attributes** `object`
  Extra details, like their nationality
  - ***** `any`

### `401` Not logged in

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

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

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

### `404` Not found

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