> ## 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 Index Details

> 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 multiple share classes listed.



## OpenAPI

````yaml https://nordicfinancialnews.com/openapi/v1/openapi.yaml get /api/v1/indices/{identifier}
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/indices/{identifier}:
    parameters:
      - name: identifier
        in: path
        required: true
        description: Index ID or symbol (e.g. `OMXS30`)
        schema:
          type: string
    get:
      tags:
        - Indices
      summary: Get Index Details
      description: >-
        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 multiple share classes listed.
      responses:
        '200':
          description: Index retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  index:
                    $ref: '#/components/schemas/IndexDetail'
                required:
                  - index
        '404':
          description: Stock index 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:
    IndexDetail:
      allOf:
        - $ref: '#/components/schemas/IndexSummary'
        - type: object
          properties:
            description:
              type: string
              nullable: true
              description: Index description
              example: The 30 most-traded stocks on Nasdaq Stockholm
            companies_count:
              type: integer
              description: >-
                Number of distinct companies in this index (may be less than
                constituents when a company has multiple share classes)
              example: 30
    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
    IndexSummary:
      type: object
      required:
        - id
        - name
        - symbol
      properties:
        id:
          type: string
          description: Unique stock index identifier
          example: idx_omxs30abc
        name:
          type: string
          description: Index display name
          example: OMX Stockholm 30
        symbol:
          type: string
          description: Index symbol
          example: OMXS30
        pan_nordic:
          type: boolean
          description: >-
            True if the index spans multiple Nordic exchanges (e.g. OMXN40),
            false if tied to a single exchange (e.g. OMXS30)
          example: false
        exchange:
          type: object
          nullable: true
          description: Exchange associated with this index
          properties:
            id:
              type: string
            name:
              type: string
            mic_code:
              type: string
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API Key authentication using Bearer token

````