> ## 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.

# API reference

> Complete reference for the Nordic Financial News REST API.

The Nordic Financial News API provides read-only access to financial news articles from Nordic sources with English headlines, summaries, and key points, AI-synthesized event summary stories, and profiles of public and private companies.

## Base URL

```
https://nordicfinancialnews.com/api/v1
```

## OpenAPI specification

The full machine-readable specification is available for import into tools like Postman, Insomnia, or Stoplight, or for generating client libraries.

<Card title="Download OpenAPI spec" icon="file-code" href="https://nordicfinancialnews.com/openapi/v1/openapi.yaml">
  OpenAPI 3.0.1 specification (YAML)
</Card>

## How to authenticate requests

All endpoints require a Bearer token in the `Authorization` header:

```bash theme={"dark"}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nordicfinancialnews.com/api/v1/articles"
```

See the [authentication guide](/guides/authentication) for details on API keys, scopes, and rate limits.

## Available API resources

Browse endpoints using the sidebar navigation. The Nordic Financial News API provides the following resources:

| Resource   | Description                                                                                                    | Endpoints                    |
| ---------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Articles   | News articles from Nordic sources with English headlines, summaries, and key points, and company associations. | List, Get                    |
| Stories    | AI-generated event narratives from multiple sources                                                            | List, Get                    |
| Search     | Full-text search across all resources                                                                          | Search                       |
| Companies  | Nordic company profiles                                                                                        | List, Get, Articles, Stories |
| Countries  | Nordic countries                                                                                               | List, Get                    |
| Exchanges  | Stock exchanges                                                                                                | List, Get, Companies         |
| Indices    | Nordic stock market indices                                                                                    | List, Get, Companies         |
| Categories | News categories                                                                                                | List                         |
| Sources    | Nordic news publishers                                                                                         | List                         |
| Watchlists | Your saved company watchlists                                                                                  | List, Get                    |
| Meta       | API metadata and capabilities                                                                                  | Get                          |

## Features available on all list endpoints

All Nordic Financial News API list endpoints support the following features. Each feature has a dedicated guide with usage examples:

* **[Cursor pagination](/guides/pagination)** for stable paging through results
* **[Field projection](/guides/field-projection)** to select specific response fields
* **[ETag caching](/guides/caching)** on individual resource endpoints
* **[Real-time updates](/guides/real-time-updates)** via the `updated_after` parameter (articles and stories)
* **Filtering** by country, category, source, ticker, content type, and date range
* **Full-text search** with the `q` parameter

## API response format

All responses are JSON. List endpoints return a resource array and a pagination object:

```json theme={"dark"}
{
  "articles": [...],
  "pagination": {
    "count": 25,
    "next_cursor": "eyJpZCI6..."
  }
}
```

Errors follow [RFC 9457 Problem Details](/guides/errors) format.