openapi: 3.0.1
info:
  title: Retell AI Agent Concurrency API
  description: REST API for building, testing, and deploying AI voice agents that make and receive phone and web calls. Configure a response engine (Retell LLM, a custom LLM, or a Conversation Flow), attach a voice, provision phone numbers, place outbound and web calls, run batch campaigns, ground agents with knowledge bases, and read back transcripts, recordings, and call analysis. All endpoints are authenticated with a Bearer API key.
  termsOfService: https://www.retellai.com/terms-of-service
  contact:
    name: Retell AI Support
    url: https://docs.retellai.com
  version: '2.0'
servers:
- url: https://api.retellai.com
security:
- api_key: []
tags:
- name: Concurrency
paths:
  /get-concurrency:
    get:
      operationId: getConcurrency
      tags:
      - Concurrency
      summary: Get current and maximum call concurrency.
      description: Returns the organization's current number of ongoing calls, base and purchased concurrency limits, burst settings, and reserved inbound concurrency.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConcurrencyResponse'
components:
  schemas:
    ConcurrencyResponse:
      type: object
      properties:
        current_concurrency:
          type: integer
          description: Number of ongoing calls in the org.
        concurrency_limit:
          type: integer
        base_concurrency:
          type: integer
          description: Free concurrency limit of the org.
        purchased_concurrency:
          type: integer
        concurrency_purchase_limit:
          type: integer
        remaining_purchase_limit:
          type: integer
        reserved_inbound_concurrency:
          type: integer
        concurrency_burst_enabled:
          type: boolean
        concurrency_burst_limit:
          type: integer
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      bearerFormat: apiKey
      description: 'Retell API key, sent as: Authorization: Bearer <RETELL_API_KEY>'