> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emitkit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get OpenAPI Specification

> Returns the OpenAPI 3.1 specification for this API in JSON format



## OpenAPI

````yaml api-reference/openapi.json get /api/openapi.json
openapi: 3.1.0
info:
  title: EmitKit API
  version: 1.0.0
  description: >
    Real-time event tracking and notifications API for modern applications.


    ## Authentication


    All API requests require authentication using an API key in the
    Authorization header:

    ```

    Authorization: Bearer emitkit_xxxxxxxxxxxxxxxxxxxxx

    ```


    API keys are scoped to organizations and projects. Create API keys in your
    dashboard.


    ## Rate Limiting


    - Default: 100 requests per minute per API key

    - Rate limit information is returned in response headers:
      - `X-RateLimit-Limit`: Maximum requests allowed
      - `X-RateLimit-Remaining`: Remaining requests in current window
      - `X-RateLimit-Reset`: Unix timestamp when limit resets

    ## Idempotency


    To safely retry requests without creating duplicates, include an
    `Idempotency-Key` header:

    ```

    Idempotency-Key: payment-123-retry-1

    ```


    Idempotency keys are valid for 24 hours. Replayed requests return the
    original response with an `X-Idempotent-Replay: true` header.


    ## Request IDs


    Every response includes a `requestId` field for debugging and support
    purposes.
  contact:
    name: EmitKit Support
    url: https://emitkit.com/support
    email: hey@emitkit.com
  license:
    name: AGPL-3.0
    url: https://www.gnu.org/licenses/agpl-3.0.en.html
servers:
  - url: https://api.emitkit.com
    description: Production API
  - url: http://localhost:5173/api
    description: Local Development
security:
  - bearerAuth: []
tags:
  - name: Events
    description: Create and manage events
  - name: Identity
    description: Track user identities and aliases
  - name: Meta
    description: API metadata and health checks
paths:
  /api/openapi.json:
    get:
      tags:
        - Meta
      summary: Get OpenAPI Specification
      description: Returns the OpenAPI 3.1 specification for this API in JSON format
      operationId: getOpenApiSpec
      responses:
        '200':
          description: OpenAPI specification
          content:
            application/json:
              schema:
                type: object
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |
        API key authentication. Format: `emitkit_xxxxxxxxxxxxxxxxxxxxx`

        Create API keys in your EmitKit dashboard. Keys are scoped to a specific
        organization and project.

````