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-usage-quota-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 Usage & Quota 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: Usage & Quota
paths:
  /api/v1/usage/me:
    get:
      tags:
      - Usage & Quota
      summary: Get My Usage
      description: 'Return current user''s aggregate usage + quota for the current billing month.


        Uses existing `APIUsageHourly.call_count` aggregation (no new tables required for Phase 1).

        Task telemetry is retained for dashboard visibility but does not gate monthly quota.'
      operationId: get_my_usage_api_v1_usage_me_get
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageMeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/usage/keys/{key_id}:
    get:
      tags:
      - Usage & Quota
      summary: Get Key Usage
      description: Return detailed usage for one API key owned by the authenticated user.
      operationId: get_key_usage_api_v1_usage_keys__key_id__get
      parameters:
      - name: key_id
        in: path
        required: true
        schema:
          type: string
          title: Key Id
      - name: Authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageKeyDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/usage/export:
    get:
      tags:
      - Usage & Quota
      summary: Export Usage
      description: 'Export usage data for enterprise/government users in JSON or CSV.


        Phase 3 scope: monetization-ready export API with cost attribution.'
      operationId: export_usage_api_v1_usage_export_get
      parameters:
      - name: format
        in: query
        required: false
        schema:
          type: string
          pattern: ^(json|csv)$
          default: json
          title: Format
      - name: start
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          description: UTC export start timestamp
          title: Start
        description: UTC export start timestamp
      - name: end
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          description: UTC export end timestamp
          title: End
        description: UTC export end timestamp
      - name: Authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    UsageKeyDetailResponse:
      properties:
        key_id:
          type: string
          title: Key Id
          description: API key UUID
        key_prefix:
          type: string
          title: Key Prefix
          description: Visible key prefix
        period:
          $ref: '#/components/schemas/UsagePeriod'
          description: Current billing period
        totals:
          additionalProperties:
            type: integer
          type: object
          title: Totals
          description: Aggregated totals for the key
        endpoint_breakdown:
          items:
            $ref: '#/components/schemas/KeyEndpointUsage'
          type: array
          title: Endpoint Breakdown
        hourly:
          items:
            $ref: '#/components/schemas/KeyHourlyUsage'
          type: array
          title: Hourly
      type: object
      required:
      - key_id
      - key_prefix
      - period
      - totals
      title: UsageKeyDetailResponse
      description: Detailed usage for a specific API key in the current month.
    UsageMeResponse:
      properties:
        user_id:
          type: string
          title: User Id
          description: User ID
        tier:
          type: string
          title: Tier
          description: Current account tier
        period:
          $ref: '#/components/schemas/UsagePeriod'
          description: Current billing period
        task_telemetry:
          additionalProperties:
            anyOf:
            - type: number
            - type: integer
          type: object
          title: Task Telemetry
          description: Task analytics (informational, not a monthly quota gate)
        calls:
          additionalProperties:
            anyOf:
            - type: number
            - type: integer
          type: object
          title: Calls
          description: Call quota usage and percentage
        keys:
          items:
            $ref: '#/components/schemas/KeyUsageSummary'
          type: array
          title: Keys
          description: Per-key breakdown
        warnings:
          items:
            additionalProperties:
              anyOf:
              - type: string
              - type: number
            type: object
          type: array
          title: Warnings
          description: Quota warning objects (70%/90% thresholds)
      type: object
      required:
      - user_id
      - tier
      - period
      - calls
      title: UsageMeResponse
      description: Response for GET /api/v1/usage/me — current user's aggregate usage.
    KeyUsageSummary:
      properties:
        key_id:
          type: string
          title: Key Id
          description: API key ID (UUID)
        prefix:
          type: string
          title: Prefix
          description: Key prefix (first 8 chars visible)
        tasks:
          type: integer
          minimum: 0.0
          title: Tasks
          description: Tasks processed by this key this month
        calls:
          type: integer
          minimum: 0.0
          title: Calls
          description: API calls made by this key this month
        last_used:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Used
          description: Last usage timestamp
      type: object
      required:
      - key_id
      - prefix
      - tasks
      - calls
      title: KeyUsageSummary
      description: Per-key usage summary for dashboard display.
    KeyEndpointUsage:
      properties:
        endpoint:
          type: string
          title: Endpoint
          description: Endpoint path
        calls:
          type: integer
          minimum: 0.0
          title: Calls
          description: Calls for this endpoint
        tasks:
          type: integer
          minimum: 0.0
          title: Tasks
          description: Tasks processed for this endpoint
        errors:
          type: integer
          minimum: 0.0
          title: Errors
          description: Error responses for this endpoint
        avg_response_ms:
          type: number
          minimum: 0.0
          title: Avg Response Ms
          description: Average response time in ms
      type: object
      required:
      - endpoint
      - calls
      - tasks
      - errors
      - avg_response_ms
      title: KeyEndpointUsage
      description: Per-endpoint usage totals for a single key.
    KeyHourlyUsage:
      properties:
        hour:
          type: string
          format: date-time
          title: Hour
          description: UTC hour bucket
        calls:
          type: integer
          minimum: 0.0
          title: Calls
        tasks:
          type: integer
          minimum: 0.0
          title: Tasks
        errors:
          type: integer
          minimum: 0.0
          title: Errors
      type: object
      required:
      - hour
      - calls
      - tasks
      - errors
      title: KeyHourlyUsage
      description: Hourly usage point for trend charts.
    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
    UsagePeriod:
      properties:
        start:
          type: string
          format: date-time
          title: Start
          description: Period start (UTC)
        end:
          type: string
          format: date-time
          title: End
          description: Period end (UTC)
      type: object
      required:
      - start
      - end
      title: UsagePeriod
      description: Billing period window (UTC month boundaries).
  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