Skip to main content
GET
/
api
/
v1
/
watchlists
/
{id}
Get Watchlist Details
curl --request GET \
  --url https://nordicfinancialnews.com/api/v1/watchlists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "watchlist": {
    "id": "a1b2c3d4e5f6",
    "name": "Tech Stocks",
    "position": 0,
    "company_count": 12,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-03-01T14:00:00Z"
  },
  "companies": [
    {
      "id": "w55fcw3pbg3p",
      "name": "Volvo Car AB",
      "slug": "VOLCAR-B",
      "ticker": "VOLCAR-B",
      "is_active": true,
      "exchange": {
        "id": "<string>",
        "name": "<string>",
        "mic_code": "<string>"
      }
    }
  ],
  "pagination": {
    "count": 123,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API Key authentication using Bearer token

Path Parameters

id
string
required

Watchlist ID (e.g. a1b2c3d4e5f6).

Query Parameters

limit
integer

Number of companies to return per page (default 25, max 100).

cursor
string

Opaque pagination cursor returned as pagination.next_cursor from a previous response.

Response

Watchlist retrieved successfully

watchlist
object
required
companies
object[]
required
pagination
object
Last modified on April 20, 2026