---
title: "Get a watchlist"
method: GET
path: "/user-management/v1/watchlists/{id}"
tags: ["user-management/watchlist"]
---

# Get a watchlist

`GET /user-management/v1/watchlists/{id}`

## Request

- Base URL: `https://api.messari.io`
- URL: `https://api.messari.io/user-management/v1/watchlists/{id}`
- Auth: API key in header `X-Messari-API-Key`
- TypeScript: <https://skmtc.dev/messari/apis/messari-api-deep-research-v1/docs/user-management/v1/watchlists/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a specific watchlist by ID for the authenticated user

## Path parameters

- `id` string, required

## Response `200`

Default response

- object
  - `data` Watchlist, required
    - `assetIds` string[], required
    - `createdAt` string, date-time, required
    - `id` string, required
    - `title` string, required
    - `updatedAt` string, date-time, required
  - `error` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/messari/apis/messari-api-deep-research-v1.md) - [All operations](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/revisions/af35b9757e14?raw)