> ## Documentation Index > Fetch the complete documentation index at: https://docs.nordicfinancialnews.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Watchlist Details > Returns watchlist details along with a paginated list of its companies, ordered alphabetically by company name. Hidden and unverified companies are excluded. Requires the `read:watchlist` scope. ## OpenAPI ````yaml https://nordicfinancialnews.com/openapi/v1/openapi.yaml get /api/v1/watchlists/{id} openapi: 3.0.1 info: title: Nordic Financial News API version: v1.0 description: > REST API for Nordic financial news. Each article is summarized in English (headline, short summary, and key points) with the original-language article linked via `article_url`. The full article body stays at the source. ## Authentication All endpoints require Bearer token authentication using an API key. Include the API key in the Authorization header: ``` Authorization: Bearer YOUR_API_KEY ``` ## Rate Limiting The API enforces per-hour rate limits based on your plan: - **Free**: 100 requests/hour - **Pro**: 5,000 requests/hour Rate limit information is included in response headers: - `X-RateLimit-Limit`: Maximum requests per hour - `X-RateLimit-Remaining`: Requests remaining - `X-RateLimit-Reset`: Seconds until limit resets - `X-RateLimit-Policy`: Human-readable rate limit policy (e.g. `5000 per hour; token bucket`) The `/health` endpoint is exempt from rate limiting and does not return rate limit headers. ## Monthly Usage Limits Each API key has a monthly request allowance based on your plan: - **Free**: 50 requests/month - **Plus**: 10,000 requests/month - **Pro**: 50,000 requests/month Monthly usage information is included in response headers: - `X-Monthly-Limit`: Maximum requests per month - `X-Monthly-Remaining`: Requests remaining this month - `X-Monthly-Reset`: ISO 8601 timestamp when the limit resets (end of month) When the monthly limit is exceeded, the API returns `429 Too Many Requests` with a `Retry-After` header. ## Caching The API supports HTTP caching with ETags. Include the `If-None-Match` header with the ETag from a previous response to receive a 304 Not Modified response if the data hasn't changed. ## Pagination List endpoints support cursor-based pagination. Use the `cursor` parameter with the value from `pagination.next_cursor` in the response to fetch the next page. Paginated responses also include a `Link` header with `rel="next"` pointing to the next page URL. ## Error Handling Errors follow the RFC 9457 Problem Details format with appropriate HTTP status codes. contact: name: API Support email: hello@nordicfinancialnews.com servers: - url: https://nordicfinancialnews.com description: Production server security: [] paths: /api/v1/watchlists/{id}: get: tags: - Watchlists summary: Get Watchlist Details description: >- Returns watchlist details along with a paginated list of its companies, ordered alphabetically by company name. Hidden and unverified companies are excluded. Requires the `read:watchlist` scope. parameters: - name: id in: path required: true description: Watchlist ID (e.g. `a1b2c3d4e5f6`). example: a1b2c3d4e5f6 schema: type: string - name: limit in: query required: false description: Number of companies to return per page (default 25, max 100). example: 25 schema: type: integer - name: cursor in: query required: false description: >- Opaque pagination cursor returned as `pagination.next_cursor` from a previous response. schema: type: string responses: '200': description: Watchlist retrieved successfully content: application/json: schema: type: object properties: watchlist: $ref: '#/components/schemas/WatchlistSummary' companies: type: array items: $ref: '#/components/schemas/CompanySummary' pagination: type: object properties: count: type: integer next_cursor: type: string nullable: true required: - watchlist - companies '401': description: Unauthorized content: application/json: examples: unauthorized: value: type: https://docs.nordicfinancialnews.com/problems/auth-invalid title: Unauthorized status: 401 detail: Missing or invalid API key instance: urn:request:abc123 schema: $ref: '#/components/schemas/problem_details' '404': description: Watchlist not found content: application/json: examples: not_found: value: type: https://docs.nordicfinancialnews.com/problems/not-found title: Not Found status: 404 detail: The requested resource could not be found instance: urn:request:abc123 schema: $ref: '#/components/schemas/problem_details' security: - bearer_auth: [] components: schemas: WatchlistSummary: type: object required: - id - name - position - company_count properties: id: type: string description: Unique watchlist identifier example: a1b2c3d4e5f6 name: type: string description: User-defined watchlist name example: Tech Stocks position: type: integer description: Display order (lower values appear first) example: 0 company_count: type: integer description: Number of companies in the watchlist example: 12 created_at: type: string format: date-time description: When the watchlist was created example: '2025-01-15T10:30:00Z' updated_at: type: string format: date-time description: When the watchlist was last modified example: '2025-03-01T14:00:00Z' CompanySummary: type: object required: - id - name - slug properties: id: type: string description: Unique company identifier example: w55fcw3pbg3p name: type: string description: Company name example: Volvo Car AB slug: type: string description: URL-friendly company name example: VOLCAR-B ticker: type: string nullable: true description: Primary stock ticker (null if unlisted) example: VOLCAR-B is_active: type: boolean description: Whether the company is currently active/operating example: true exchange: type: object nullable: true description: Primary exchange where the company is listed properties: id: type: string description: Exchange identifier name: type: string description: Exchange display name mic_code: type: string description: ISO 10383 Market Identifier Code problem_details: type: object required: - type - title - status - detail - instance properties: type: type: string description: URI that identifies the problem type title: type: string description: Short human-readable summary status: type: integer description: HTTP status code detail: type: string description: Human-readable explanation instance: type: string description: URI that identifies the specific occurrence securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: API Key description: API Key authentication using Bearer token ````