# Nordic Financial News

- [Nordic Financial News API](https://docs.nordicfinancialnews.com/index.md): Structured, translated financial news from 70+ Nordic sources, delivered through a REST API, MCP server, and CLI tool.
- [Getting started](https://docs.nordicfinancialnews.com/getting-started.md): Get your API key and make your first request to the Nordic Financial News API.
- [AI tools & resources](https://docs.nordicfinancialnews.com/ai-tools.md): Use AI assistants and agents to explore the Nordic Financial News API and API docs.
- [Coverage](https://docs.nordicfinancialnews.com/coverage.md): Sources covered by the Nordic Financial News API, organized by type.
- [Support](https://docs.nordicfinancialnews.com/support.md): Get help with the Nordic Financial News API.
- [Authentication](https://docs.nordicfinancialnews.com/guides/authentication.md): API key authentication, scopes, rate limits, and monthly usage quotas.
- [Pagination](https://docs.nordicfinancialnews.com/guides/pagination.md): Cursor-based pagination for stable, efficient paging through large result sets.
- [Caching](https://docs.nordicfinancialnews.com/guides/caching.md): Use ETags and conditional requests to save bandwidth and reduce API usage.
- [Real-time updates](https://docs.nordicfinancialnews.com/guides/real-time-updates.md): Keep a local mirror in sync using the updated_after incremental-sync walk.
- [Field projection](https://docs.nordicfinancialnews.com/guides/field-projection.md): Select specific response fields to minimize payload size and speed up requests.
- [Error handling](https://docs.nordicfinancialnews.com/guides/errors.md): Error format, status codes, and how to handle API errors.
- [How to get company news](https://docs.nordicfinancialnews.com/api-examples/company-news.md): Fetch news events for a specific Nordic company by ticker or company ID, open the articles and stories behind them, and filter by event type, significance, source, and date.
- [How to get Nordic earnings dates and dividend calendars](https://docs.nordicfinancialnews.com/api-examples/calendar-events.md): Fetch scheduled Nordic earnings reports, dividends, AGMs, and M&A deadlines, then filter the calendar by company, index, and date window.
- [CLI](https://docs.nordicfinancialnews.com/cli/index.md): Install and use the Nordic Financial News CLI to query articles, stories, companies, and more from your terminal.
- [Commands](https://docs.nordicfinancialnews.com/cli/commands.md): Complete reference for all Nordic Financial News CLI commands.
- [MCP server](https://docs.nordicfinancialnews.com/model-context-protocol/index.md): Connect AI assistants to query Nordic Financial News data using the Model Context Protocol.
- [Tools](https://docs.nordicfinancialnews.com/model-context-protocol/tools.md): MCP tools available for querying Nordic Financial News data.
- [Resources](https://docs.nordicfinancialnews.com/model-context-protocol/resources.md): MCP resources for priming AI assistant context with recent Nordic financial data.
- [Invalid parameter](https://docs.nordicfinancialnews.com/problems/invalid-parameter.md): The 400 problem type returned when a query parameter is unusable, naming it in a parameter member.
- [Authentication required](https://docs.nordicfinancialnews.com/problems/auth-invalid.md): The 401 problem type returned when a request carries no usable API key.
- [Insufficient permissions](https://docs.nordicfinancialnews.com/problems/auth-insufficient.md): The 403 problem type returned when a valid API key is not permitted to make the request.
- [Plan limit exceeded](https://docs.nordicfinancialnews.com/problems/plan-limit-exceeded.md): The 403 problem type returned when your plan does not reach the requested content or feature.
- [Not found](https://docs.nordicfinancialnews.com/problems/not-found.md): The 404 problem type returned when a path or identifier does not resolve.
- [Rate limit exceeded](https://docs.nordicfinancialnews.com/problems/rate-limit-exceeded.md): The 429 problem type returned when a request exceeds a rate limit.
- [Monthly limit exceeded](https://docs.nordicfinancialnews.com/problems/monthly-limit-exceeded.md): The 429 problem type returned when an API key's account has used its monthly request allowance.
- [Semantic search unavailable](https://docs.nordicfinancialnews.com/problems/semantic-unavailable.md): The 503 problem type returned when a semantic search cannot be completed.
- [API reference](https://docs.nordicfinancialnews.com/api-reference/introduction.md): Complete reference for the Nordic Financial News REST API.
- [List Events](https://docs.nordicfinancialnews.com/api-reference/events/list-events.md): Returns a paginated list of Events. An event groups the articles reporting a single real-world development (an earnings report, an M&A announcement, a dividend, an executive change, and so on). Sorted by when the event was first reported, most recent first.
- [Get Event](https://docs.nordicfinancialnews.com/api-reference/events/get-event.md): Fetches a single event by ID.
- [List Articles](https://docs.nordicfinancialnews.com/api-reference/articles/list-articles.md): Returns a paginated list of live articles ordered by publication date (newest first). Each article includes an English headline, a short summary, and key points, with `article_url` linking to the full original-language article at the source.
- [Get Article Details](https://docs.nordicfinancialnews.com/api-reference/articles/get-article-details.md): Returns the details of a single article: an English headline, a short summary, key points, and associated companies, along with `article_url` pointing to the full original-language article at the source. Supports conditional requests via `If-None-Match` for efficient caching.
- [List Stories](https://docs.nordicfinancialnews.com/api-reference/stories/list-stories.md): Returns a paginated list of published stories ordered by publication date (newest first). Each story synthesizes coverage of a single developing event from multiple source articles into one narrative.
- [Get Story Details](https://docs.nordicfinancialnews.com/api-reference/stories/get-story-details.md): Returns the full details of a single story, including content in Markdown format, associated articles, and companies. Supports conditional requests via `If-None-Match` for efficient caching.
- [List Calendar Events](https://docs.nordicfinancialnews.com/api-reference/calendar-events/list-calendar-events.md): Returns a paginated list of scheduled Nordic financial calendar events: earnings reports (Q1 / H1 / FY etc.), earnings calls, trading updates, AGMs/EGMs, capital markets days, conference presentations, dividends, and M&A milestones (announcements, offer deadlines, completions).
- [Get Calendar Event](https://docs.nordicfinancialnews.com/api-reference/calendar-events/get-calendar-event.md): Fetches a single scheduled calendar event by ID. Cancelled or discarded events return 404.
- [Search](https://docs.nordicfinancialnews.com/api-reference/search/search.md): Search across articles, stories, companies, countries, exchanges, and indices. Results are grouped by resource type and ranked by relevance. Use `type` to limit which resource types are searched.
- [List Companies](https://docs.nordicfinancialnews.com/api-reference/companies/list-companies.md): Returns a paginated list of companies covered in Nordic financial news, ordered alphabetically by name. Use `q` for full-text search across company names, ranked by relevance, or add `mode=semantic` to match `q` by meaning instead.
- [Get Company Details](https://docs.nordicfinancialnews.com/api-reference/companies/get-company-details.md): Returns detailed information about a single company, including description, sector, relationships, and stock listings. Look up by company ID (e.g. `comp_apple123`) or ticker symbol (e.g. `AAPL`, `VOLV-B`). Lookup also accepts the full ticker including exchange suffix (e.g. `VOLV-B.ST`).
- [List Company Articles](https://docs.nordicfinancialnews.com/api-reference/companies/list-company-articles.md): Returns articles where the company is a principal association (subject, partner, investor, or competitor), ordered by publication date (newest first). An article where this company is only the source, an advisor, or a passing mention is excluded.
- [List Company Stories](https://docs.nordicfinancialnews.com/api-reference/companies/list-company-stories.md): Returns stories that mention a specific company, ordered by publication date (newest first).
- [List Company Events](https://docs.nordicfinancialnews.com/api-reference/companies/list-company-events.md): Returns Events this company participates in, newest first. This is the same contract as `GET /api/v1/events`, scoped to a single company by the path. Plan gating, ordering, `updated_after` sync (including merge/removal tombstones for this company), and cursor semantics all match the flat resource; s…
- [List Company Calendar Events](https://docs.nordicfinancialnews.com/api-reference/companies/list-company-calendar-events.md): Returns upcoming scheduled calendar events for a single company (earnings reports, AGMs/EGMs, dividends, and more), ordered by `scheduled_at` ascending. This is the same contract as `GET /api/v1/calendar_events`, scoped to a single company by the path.
- [List Countries](https://docs.nordicfinancialnews.com/api-reference/countries/list-countries.md): Returns the Nordic countries covered by the API, ordered alphabetically. Use the country `id` or `iso2_code` to filter articles, stories, and companies by country.
- [Get Country Details](https://docs.nordicfinancialnews.com/api-reference/countries/get-country-details.md): Returns details for a single country, including its stock exchanges. Look up by country ID or ISO 3166-1 alpha-2 code (e.g. `SE`).
- [List Exchanges](https://docs.nordicfinancialnews.com/api-reference/exchanges/list-exchanges.md): Returns active Nordic stock exchanges, ordered alphabetically. Supports filtering by country.
- [Get Exchange Details](https://docs.nordicfinancialnews.com/api-reference/exchanges/get-exchange-details.md): Returns detailed information about a stock exchange, including currency, timezone, and location. Look up by exchange ID (e.g. `exch_nasdaq1`) or MIC code (e.g. `XSTO`).
- [List Exchange Companies](https://docs.nordicfinancialnews.com/api-reference/exchanges/list-exchange-companies.md): Returns companies listed on a specific exchange, ordered alphabetically. The `ticker` and `exchange` shown for each company reflect its primary listing, which may be on a different exchange if the company is listed on multiple exchanges.
- [List Indices](https://docs.nordicfinancialnews.com/api-reference/indices/list-indices.md): Returns stock indices, ordered alphabetically by name. Use `exchange` to filter by a specific exchange.
- [Get Index Details](https://docs.nordicfinancialnews.com/api-reference/indices/get-index-details.md): Returns details for a single index, including description and company count. Look up by index ID or symbol (case-insensitive, e.g. `OMXS30`). Note: `companies_count` reflects the number of distinct companies in the index, which may be less than the number of index constituents when a company has mul…
- [List Index Companies](https://docs.nordicfinancialnews.com/api-reference/indices/list-index-companies.md): Returns companies that are members of a specific index, ordered alphabetically. The `ticker` and `exchange` shown for each company reflect its primary listing, which may differ from the listing used in this index (e.g. a company listed on multiple exchanges).
- [List Categories](https://docs.nordicfinancialnews.com/api-reference/categories/list-categories.md): Returns all enabled article categories, ordered alphabetically by name. Categories are used to classify articles and stories (e.g. Earnings, M&A, IPO). Use category IDs to filter articles and stories by topic.
- [List Event Types](https://docs.nordicfinancialnews.com/api-reference/event-types/list-event-types.md): Returns all active event types, grouped by category (in the categories' defined order) and ordered by slug within each. Event type slugs are the values for the `event_type` filter on `GET /api/v1/events`.
- [List Sources](https://docs.nordicfinancialnews.com/api-reference/sources/list-sources.md): Returns a paginated list of enabled news sources, ordered alphabetically by name. Use source IDs to filter articles and stories via the `sources` parameter on the articles and stories list endpoints.
- [List Watchlists](https://docs.nordicfinancialnews.com/api-reference/watchlists/list-watchlists.md): 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 Watchlist Details](https://docs.nordicfinancialnews.com/api-reference/watchlists/get-watchlist-details.md): 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.
- [Get API metadata](https://docs.nordicfinancialnews.com/api-reference/meta/get-api-metadata.md): Returns API metadata including version, capabilities, supported fields, content types, and rate limit policy.
- [Health check endpoint](https://docs.nordicfinancialnews.com/api-reference/health/health-check-endpoint.md): Returns the health status of the API
- [Changelog](https://docs.nordicfinancialnews.com/changelog.md): New features, improvements, and bug fixes across the Nordic Financial News API, MCP server, and CLI.

## OpenAPI Specs

- [openapi](https://nordicfinancialnews.com/openapi/v1/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.