> ## 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. # List Calls > List calls with filtering, sorting, and pagination ## OpenAPI ````yaml GET /calls 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: get: tags: - Calls summary: List Calls description: List calls with filtering, sorting, and pagination operationId: listCalls parameters: - name: page in: query description: Page number schema: type: integer minimum: 1 default: 1 - name: pageSize in: query description: Items per page schema: type: integer minimum: 1 maximum: 100 default: 25 - name: sortBy in: query description: Sort field schema: type: string enum: - createdAt - startedAt - endedAt - durationSeconds - status - direction default: createdAt - name: sortDir in: query description: Sort direction schema: type: string enum: - asc - desc default: desc - name: status in: query description: Filter by status (comma-separated) schema: type: string - name: direction in: query description: Filter by direction schema: type: string enum: - INBOUND - OUTBOUND - name: agentId in: query description: Filter by agent ID schema: type: string format: uuid - name: folderId in: query description: >- Filter by the call's agent folder. Pass a folder ID to only return calls whose agent is in that folder, or `none` to only return calls whose agent has no folder. Calls whose agent has been deleted are not returned by this filter. schema: type: string - name: sipTrunkId in: query description: Filter by SIP trunk ID schema: type: string format: uuid - name: fromNumber in: query description: Filter by from number (E.164) schema: type: string - name: toNumber in: query description: Filter by to number (E.164) schema: type: string - name: createdFrom in: query description: Filter by creation date (ISO 8601) schema: type: string format: date-time - name: createdTo in: query description: Filter by creation date (ISO 8601) schema: type: string format: date-time - name: q in: query description: Search query schema: type: string maxLength: 64 responses: '200': description: Paginated list of calls content: application/json: schema: $ref: '#/components/schemas/CallsList' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/BillingInactiveError' components: schemas: CallsList: type: object description: Paginated list of calls properties: data: type: array description: Array of call records items: $ref: '#/components/schemas/Call' page: type: integer minimum: 1 description: Current page number pageSize: type: integer minimum: 1 maximum: 100 description: Number of items per page total: type: integer description: Total number of calls matching filters hasNextPage: type: boolean description: Whether there are more pages available required: - data - page - pageSize - total - hasNextPage 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. ````