Watchlists

List Watchlists

Returns all watchlists belonging to the authenticated user, ordered by position (ascending) then creation date. Each watchlist includes a company count but not the full company list. Use the Get Watchlist Details endpoint to retrieve companies. Requires the read:watchlist scope.

get/api/v1/watchlists

Request

Base URL
https://nordicfinancialnews.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/docs/api/v1/watchlists/get.ts
A function with typed inputs. Its response is checked against the schema.

Headers

If-None-Matchstring

ETag value from a previous response. Returns 304 Not Modified if data has not changed.

If-Modified-Sincestring

HTTP date from a previous Last-Modified header. Returns 304 Not Modified if nothing has changed since.

Response

Watchlists retrieved successfully

Example response

{
  "watchlists": [
    {
      "id": "a1b2c3d4e5f6",
      "name": "Tech Stocks",
      "company_count": 12,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-03-01T14:00:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.