> ## Documentation Index > Fetch the complete documentation index at: https://docs.revring.ai/llms.txt > Use this file to discover all available pages before exploring further. # Batch Get Calls > Fetch multiple calls by ID in a single request. Unknown IDs are omitted from the response. Maximum 100 IDs per request. ## OpenAPI ````yaml POST /calls/batch-get openapi: 3.1.0 info: title: RevRing Voice AI API description: >- RevRing Voice AI platform API for managing AI voice agents, phone calls, SIP trunks, and analytics. Build intelligent voice applications that can handle inbound and outbound phone calls with AI-powered conversational agents. version: 1.0.0 contact: name: RevRing Support url: https://revring.ai servers: - url: https://api.revring.ai/v1 description: Production API security: - apiKeyAuth: [] tags: - name: Messaging Connections description: Connect messaging providers so agents can send text messages - name: Messages description: Send text messages and read your message log - name: Conversations description: List and clear managed conversation threads - name: SIP Trunks description: Manage SIP trunks for connecting agents to the phone network - name: Agents description: Manage AI voice agents and their configuration - name: Agent Folders description: Organize agents into folders for dashboard navigation - name: Calls description: Manage and query phone calls - name: Analytics description: Get analytics and metrics about your calls - name: Knowledge Bases description: >- Manage knowledge bases and sources for agent retrieval-augmented generation - name: Test Suites description: Manage test suites, test cases, and test runs for agent evaluation - name: Voices description: Browse the voices available to your organization for agent speech paths: /calls/batch-get: post: tags: - Calls summary: Batch Get Calls description: >- Fetch multiple calls by ID in a single request. Unknown IDs are omitted from the response. Maximum 100 IDs per request. operationId: batchGetCalls requestBody: required: true content: application/json: schema: type: object required: - ids properties: ids: type: array description: Call IDs to fetch items: type: string minItems: 1 maxItems: 100 minimal: type: boolean description: >- Return a compact representation, omitting transcript, summary, metrics, and variables default: false responses: '200': description: Matching calls content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Call' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/BillingInactiveError' components: schemas: Call: type: object description: Phone call record properties: id: type: string format: uuid organizationId: type: string format: uuid agentId: type: string format: uuid nullable: true sipTrunkId: type: string format: uuid nullable: true direction: type: string enum: - INBOUND - OUTBOUND description: Call direction status: type: string enum: - QUEUED - INITIATED - ONGOING - TRANSFERRED - COMPLETED - FAILED - CANCELED description: Current call status fromNumber: type: string description: >- Caller's number (E.164). For web widget calls, the visitor's anonymous ID in the form visitor:. toNumber: type: string description: Called number (E.164). For web widget calls, the agent ID. source: type: string nullable: true enum: - web_widget - null description: >- How the call originated. web_widget for calls started from the Web Widget call button; null for phone calls. continuedFromCallId: type: string nullable: true description: >- When a dropped web widget call was silently re-dialed, the id of the call this one continues; null otherwise. agentCallerIdName: type: string nullable: true description: Caller ID name shown to recipient agentName: type: string nullable: true description: Name of the agent that handled this call variables: type: object nullable: true description: Template variables used recordingUrl: type: string nullable: true description: URL to call recording (available after call ends) hangupCause: type: string nullable: true description: >- Reason call ended. Common values: USER_ENDED, END_CALL_TOOL, SILENCE_TIMEOUT, MAX_DURATION, VOICEMAIL_DETECTED errorMessage: type: string nullable: true description: Error message if call failed transcript: type: array nullable: true description: Conversation transcript items: type: object summary: type: string nullable: true description: AI-generated summary metrics: type: object nullable: true description: Call quality and performance metrics initiatedAt: type: string format: date-time description: When call was initiated startedAt: type: string format: date-time nullable: true description: When call was answered (null if never answered) endedAt: type: string format: date-time nullable: true description: When call ended (null if still ongoing) durationSeconds: type: integer nullable: true description: Call duration in seconds (null if never answered) llmModel: type: string nullable: true enum: - revring-standard - revring-max - revring-ultra - null description: >- Language model tier the call ran on, fixed at call start. null for calls placed before model tiers existed (billed at the standard rate). postCallWebhookStatus: type: string nullable: true enum: - sent - failed - null description: Status of post-call webhook delivery preCallWebhookStatus: type: string nullable: true enum: - sent - failed - skipped - null description: Status of pre-call webhook delivery createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - organizationId - direction - status - fromNumber - toNumber - initiatedAt - createdAt - updatedAt responses: BadRequestError: description: Invalid request parameters content: application/json: schema: type: object properties: error: type: string example: invalid_body details: type: object UnauthorizedError: description: Authentication required or API key invalid content: application/json: schema: type: object properties: error: type: string example: unauthorized BillingInactiveError: description: Subscription inactive or billing issue content: application/json: schema: type: object properties: error: type: string example: billing_inactive securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key for authentication. Generate API keys from the RevRing dashboard. ````