find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/bellatorsi-com:bellatorsi-com-api-keys-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Bellator Schedule Intelligence API Keys API
  description: 'Bellator Schedule Intelligence APIs - Stateless Schedule Health APIs


    ## Features


    * **Schedule Analysis** - Comprehensive schedule health analysis

    * **Critical Path** - CPM-based critical path calculation

    * **Validation** - Schedule validation and quality checks

    * **Future: Resource Management** - Resource allocation and leveling

    * **Future: Simulation** - Monte Carlo and what-if analysis

    * **Future: AI Recommendations** - LLM-powered optimization suggestions


    ## Authentication


    API key authentication via `x-api-key` header or OAuth 2.0 Bearer token via `Authorization` header.


    ### API Key Authentication (Legacy)

    Include API key in `x-api-key` header.


    ### OAuth 2.0 / Azure AD Authentication (Recommended)

    Include Bearer token in `Authorization` header: `Authorization: Bearer `


    Tiers:

    - **Free**: 2,000 tasks, 100 req/min, 5MB payload

    - **Professional**: 5,000 tasks, 500 req/min, 25MB payload

    - **Enterprise**: 50,000 tasks, 2,000 req/min, 100MB payload

    - **Government**: 100,000+ tasks, 10,000 req/min, 500MB payload


    ## Usage Metering


    All API requests are metered and tracked for:

    - Request duration (milliseconds)

    - Task count processed

    - Token consumption (for LLM operations)

    - Estimated cost (USD)


    Metering events are emitted to logs and can be integrated with billing systems.


    ## Security


    * Tier-based task limits (500-100,000 tasks per request)

    * Tier-based payload limits (5-500 MB)

    * Input validation and sanitization

    * Tier-based rate limiting (100-10,000 requests per 60 seconds)'
  version: 0.4.0
tags:
- name: API Keys
paths:
  /api/v1/keys/ephemeral/generate:
    post:
      tags:
      - API Keys
      summary: Generate Ephemeral API Key
      description: 'Generate a new ephemeral API key for playground use.


        **No authentication required.** Returns a temporary key that:

        - Expires after 24 hours

        - Limited to 100 API calls

        - Tracked individually (not shared between users)

        - Auto-deletes when expired


        **Use Cases:**

        - Playground users exploring the API

        - Quick testing without signup

        - Trial integrations


        **Upgrade Path:**

        When limits are reached, users can:

        1. Generate a new ephemeral key (instant, no signup)

        2. Sign up for unlimited access at https://www.bellatorsi.com/pricing


        **Security:**

        - Keys are cryptographically secure (128-bit entropy)

        - Usage tracked per key for abuse prevention

        - Automatic expiry prevents key leakage issues'
      operationId: generate_ephemeral_key_api_v1_keys_ephemeral_generate_post
      responses:
        '201':
          description: Ephemeral key generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EphemeralKeyResponse'
        '429':
          description: 'Generation rate limit exceeded — caller has generated too many keys today (default: 5 keys/IP/day).  Retry tomorrow or sign up for unlimited access.'
        '503':
          description: Key generation temporarily unavailable — Redis backend is unreachable and the service is configured in fail-closed mode.  Retry shortly.
        '500':
          description: Failed to generate key (unexpected internal error)
  /api/v1/keys/ephemeral/generate/agent:
    post:
      tags:
      - API Keys
      summary: Generate Agent Ephemeral Key
      description: Issue a no-signup agent key at the free tier. Same mint, different tier.
      operationId: generate_agent_key_api_v1_keys_ephemeral_generate_agent_post
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EphemeralKeyResponse'
  /api/v1/keys/ephemeral/info:
    get:
      tags:
      - API Keys
      summary: Get Key Usage Info
      description: 'Get usage information for current ephemeral key.


        **Authentication Required:** Include ephemeral key in `X-API-Key` header.


        Returns:

        - Usage count and remaining calls

        - Time until expiry

        - Key validity status


        **Use Cases:**

        - Display usage meter in playground UI

        - Warn users when approaching limits

        - Trigger upgrade prompts'
      operationId: get_key_info_api_v1_keys_ephemeral_info_get
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Key information retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyUsageInfoResponse'
        '404':
          description: Key not found or expired
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/keys/ephemeral/revoke:
    delete:
      tags:
      - API Keys
      summary: Revoke Ephemeral Key
      description: 'Revoke current ephemeral key immediately.


        **Authentication Required:** Include ephemeral key in `X-API-Key` header.


        **Use Cases:**

        - User explicitly requests key deletion

        - Security: User suspects key compromise

        - Privacy: User wants to clear session data


        **Note:** Keys auto-expire after 24 hours, so manual revocation is optional.'
      operationId: revoke_key_api_v1_keys_ephemeral_revoke_delete
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Key revoked successfully or not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RevokeKeyResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EphemeralKeyResponse:
      properties:
        api_key:
          type: string
          title: Api Key
          description: The generated ephemeral API key
        expires_at:
          type: string
          title: Expires At
          description: ISO 8601 expiry timestamp
        usage_limit:
          type: integer
          title: Usage Limit
          description: Maximum number of API calls allowed
        usage_remaining:
          type: integer
          title: Usage Remaining
          description: Remaining API calls
        type:
          type: string
          title: Type
          description: Key type (ephemeral)
        tier:
          type: string
          title: Tier
          description: Issued tier. demo or free.
          default: demo
        note:
          type: string
          title: Note
          description: Usage instructions and upgrade information
      type: object
      required:
      - api_key
      - expires_at
      - usage_limit
      - usage_remaining
      - type
      - note
      title: EphemeralKeyResponse
      description: Response model for ephemeral key generation.
    KeyUsageInfoResponse:
      properties:
        usage_count:
          type: integer
          title: Usage Count
          description: Number of API calls made
        usage_limit:
          type: integer
          title: Usage Limit
          description: Maximum number of API calls allowed
        usage_remaining:
          type: integer
          title: Usage Remaining
          description: Remaining API calls
        ttl_seconds:
          type: integer
          title: Ttl Seconds
          description: Seconds until key expires
        expires_at:
          type: string
          title: Expires At
          description: ISO 8601 expiry timestamp
        created_at:
          type: string
          title: Created At
          description: ISO 8601 creation timestamp
          default: ''
        type:
          type: string
          title: Type
          description: Key type
          default: ephemeral
      type: object
      required:
      - usage_count
      - usage_limit
      - usage_remaining
      - ttl_seconds
      - expires_at
      title: KeyUsageInfoResponse
      description: Response model for key usage information.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    RevokeKeyResponse:
      properties:
        message:
          type: string
          title: Message
          description: Status message
        revoked:
          type: boolean
          title: Revoked
          description: Whether key was successfully revoked
      type: object
      required:
      - message
      - revoked
      title: RevokeKeyResponse
      description: Response model for key revocation.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Required when API_KEY is configured.
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize
          tokenUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
          scopes:
            api.read: Read access to API
            api.write: Write access to API
      description: OAuth 2.0 / Azure AD authentication (recommended)
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Bearer token from OAuth 2.0 / Azure AD