# List what you've seen

`GET` `https://streetartcities.com/api/profiles/me/seen`

The artworks the person marked as seen or hunted themselves, newest first. Artworks they saw more than once are only listed once, with the last time they saw them. Use `updatedSince` to only get what was added since you last checked, including old visits they logged since.

## Query parameters

- **updatedSince** `string` · date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
  Only what was added to the list since this time, like `2026-09-01T00:00:00Z`
- **page** `integer` · >= 1 · <= 9007199254740991 · default: 1
  Which page of results, starting at 1
- **perPage** `integer` · >= 1 · <= 100 · default: 20
  How many results per page (20 by default, at most 100)

## Requirements

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

## Responses

### `200` A page of seen artworks

- **items** `array ProfileItem[]` — required
  - _Array of ProfileItem_
    - **type** `string` — required
      What it is: `marker` for an artwork or other place on the map, or `comment` for a comment on one
    - **id** `string` — required
    - **title** `string`
    - **artistsString** `string`
      The artists' names, separated by commas
    - **thumbnail** `string`
    - **href** `string`
      Link to it on Street Art Cities
    - **comment** `string`
      For comments: what the comment says
    - **createdAt** `string`
      When they liked, saw or hunted it. Seen dates can be in the past, when someone logged an old visit
- **page** `number` — required
- **perPage** `number` — required
- **total** `number` — required
  How many there are, over all pages

### `400` Invalid request

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

### `401` Not logged in

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

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

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