> ## Documentation Index
> Fetch the complete documentation index at: https://cinepro-changelog-2026-05-21.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API version and available endpoints

> Returns version information and available endpoints.



## OpenAPI

````yaml get /v1
openapi: 3.0.0
info:
  title: Open Media Streaming Specification (OMSS)
  description: >
    A standardized REST API specification for streaming backends to expose
    movies, TV episodes, 

    sources, and subtitles. OMSS enables interoperability between streaming
    backends and frontends.


    **Key Features:**

    - Standardized endpoints for movies and TV episodes

    - Proxy-based source delivery with header support

    - Multi-language and multi-quality source support

    - Subtitle support with multiple formats

    - Diagnostic reporting for partial scrapes

    - Caching optimization recommendations

    - HTTPS-enforced security


    **Reference Implementation:** https://github.com/omss-spec/omss-spec
  version: 1.0.0
  license:
    name: MIT License
    url: https://github.com/omss-spec/omss-spec/blob/main/LICENSE
  contact:
    name: OMSS Community
    url: https://github.com/omss-spec/omss-spec
servers:
  - url: https://api.example.com
    description: Production server (HTTPS required)
    variables:
      version:
        default: v1
        enum:
          - v1
  - url: http://localhost:3000
    description: Development server (localhost only)
security: []
tags:
  - name: Content
    description: Retrieve sources for movies and TV shows
  - name: Proxy
    description: Proxy endpoint to play content by upstream providers
  - name: Health
    description: Health and version information. All endpoints return the same object.
  - name: Refresh
    description: Refresh cached sources
paths:
  /v1:
    get:
      tags:
        - Health
      summary: API version endpoint
      description: Returns version information and available endpoints.
      operationId: getVersion
      responses:
        '200':
          description: Backend is operational
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
              example:
                name: My OMSS Backend
                version: 1.0.0
                status: operational
                endpoints:
                  movie: /v1/movies/{id}
                  tv: /v1/tv/{id}/seasons/{s}/episodes/{e}
                  proxy: /v1/proxy/?data={encoded_data}
                spec: omss
                note: Community-powered streaming backend
components:
  schemas:
    HealthResponse:
      type: object
      required:
        - name
        - version
        - status
        - spec
      properties:
        name:
          type: string
          description: Human-readable name of the backend
          example: My OMSS Backend
        version:
          type: string
          description: Backend version (semantic versioning)
          example: 1.0.0
        status:
          type: string
          enum:
            - operational
            - degraded
            - maintenance
            - offline
          description: Current operational status
        endpoints:
          type: object
          description: Available endpoint paths
          properties:
            movie:
              type: string
              example: /v1/movies/{id}
            tv:
              type: string
              example: /v1/tv/{id}/seasons/{s}/episodes/{e}
            proxy:
              type: string
              example: /v1/proxy/?data={encoded_data}
        spec:
          type: string
          enum:
            - omss
          description: Standard name (always "omss")
        note:
          type: string
          description: Optional note about the backend or recommended frontend
          example: >-
            Community-powered streaming backend. Visit
            https://github.com/mybackend for more info.

````