> ## Documentation Index > Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt > Use this file to discover all available pages before exploring further. # List voice calls > Return paginated call history across all leads and campaigns. Includes outcome, duration, and an opaque recording reference for each call. ## OpenAPI ````yaml /openapi.json get /api/v1/public/voice/calls openapi: 3.1.0 info: description: >- Customer-facing API for managing outreach, leads, conversations, voice agents, knowledge bases, analytics, and webhooks. title: Sendora Public API version: 1.0.0 servers: - description: Production url: https://api.sendora.ai security: [] tags: - description: Build, launch, pause and stop campaigns, and enroll leads. name: Campaigns - description: Create, update, tag, enrich and import leads. name: Leads - description: Group leads into reusable lists. name: Lead lists - description: Find new prospects and research existing leads. name: Prospecting - description: Read conversations and send messages to leads. name: Inbox - description: Manage workspace-wide suppressions. name: Do not contact - description: Manage the content your agents answer from. name: Knowledge bases - description: Create, configure, test and publish voice agents. name: Voice agents - description: Give agents actions such as booking, lookups and transfers. name: Agent tools - description: Embed a voice agent on your website. name: Voice widgets - description: Start voice calls and read call results. name: Calls - description: Browse and preview the voices an agent can use. name: Voices - description: List numbers, bring your own, and route calls. name: Phone numbers - description: List the channel accounts connected to the workspace. name: Connected accounts - description: Register endpoints and review deliveries. name: Webhooks - description: Drive the workspace assistant programmatically. name: Copilot - description: Read workspace and campaign performance. name: Analytics - description: Track asynchronous operations. name: Jobs - description: Manage client workspaces, plans and branding. name: Agency paths: /api/v1/public/voice/calls: get: tags: - Calls summary: List voice calls description: >- Return paginated call history across all leads and campaigns. Includes outcome, duration, and an opaque recording reference for each call. operationId: public_list_calls_api_v1_public_voice_calls_get parameters: - in: query name: page required: false schema: default: 1 minimum: 1 title: Page type: integer - in: query name: per_page required: false schema: default: 50 maximum: 200 minimum: 1 title: Per Page type: integer - description: Only calls to this lead. Use the `id` from List all leads. in: query name: lead_id required: false schema: anyOf: - type: string - type: 'null' description: Only calls to this lead. Use the `id` from List all leads. title: Lead Id - description: >- Only calls placed by this voice agent. Use the `id` from List voice agents. in: query name: agent_id required: false schema: anyOf: - type: string - type: 'null' description: >- Only calls placed by this voice agent. Use the `id` from List voice agents. title: Agent Id - description: >- Only calls placed by this campaign. Use the `id` from List campaigns. in: query name: campaign_id required: false schema: anyOf: - type: string - type: 'null' description: >- Only calls placed by this campaign. Use the `id` from List campaigns. title: Campaign Id - description: 'Filter by outcome: answered | voicemail | no-answer | busy | failed' in: query name: disposition required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by outcome: answered | voicemail | no-answer | busy | failed title: Disposition - in: header name: X-API-Key required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: Authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedCalls' description: Successful Response '401': description: The X-API-Key header is missing, invalid, expired, or revoked. '402': description: >- The workspace is suspended for billing, or the request would exceed a plan or usage limit. '403': description: >- The key is valid but lacks the required scope, or the workspace has no active plan, lacks the entitlement, or has this feature turned off or view-only. '410': description: The workspace behind this key has been deleted. '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error '500': description: >- An unexpected Sendora error occurred. Retry only if the operation is safe to repeat. '503': description: >- An entitlement or billing check is temporarily unavailable. Retry after the Retry-After interval. security: - ApiKeyAuth: [] x-codeSamples: - label: cURL lang: bash source: >- curl -X GET 'https://api.sendora.ai/api/v1/public/voice/calls' -H "X-API-Key: $SENDORA_API_KEY" - label: Python lang: python source: |- import requests url = 'https://api.sendora.ai/api/v1/public/voice/calls' headers = {'X-API-Key': '$SENDORA_API_KEY'} response = requests.get(url, headers=headers) response.raise_for_status() print(response.json()) - label: JavaScript lang: javascript source: >- const response = await fetch("https://api.sendora.ai/api/v1/public/voice/calls", { method: "GET", headers: { 'X-API-Key': process.env.SENDORA_API_KEY }, }); if (!response.ok) throw new Error(await response.text()); console.log(await response.json()); - label: Go lang: go source: >- req, err := http.NewRequest("GET", "https://api.sendora.ai/api/v1/public/voice/calls", nil) if err != nil { log.Fatal(err) } req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY")) resp, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close() components: schemas: PaginatedCalls: properties: items: description: Items returned by the Sendora API. items: $ref: '#/components/schemas/api__v1__public__voice_calls__CallOut' title: Items type: array page: description: Page returned by the Sendora API. title: Page type: integer per_page: description: Per page returned by the Sendora API. title: Per Page type: integer total: description: Total returned by the Sendora API. title: Total type: integer required: - items - total - page - per_page title: PaginatedCalls type: object HTTPValidationError: properties: detail: description: Detail returned by the Sendora API. items: $ref: '#/components/schemas/ValidationError' title: Detail type: array required: [] title: HTTPValidationError type: object api__v1__public__voice_calls__CallOut: properties: agent_id: anyOf: - type: string - type: 'null' description: >- The voice agent that placed the call: an `id` from List voice agents. title: Agent Id ai_summary: anyOf: - type: string - type: 'null' description: Ai summary returned by the Sendora API. title: Ai Summary campaign_id: anyOf: - type: string - type: 'null' description: >- The campaign that placed the call, when there is one: an `id` from List campaigns. title: Campaign Id created_at: anyOf: - type: string - type: 'null' description: Created at returned by the Sendora API. title: Created At disposition: anyOf: - type: string - type: 'null' description: Disposition returned by the Sendora API. title: Disposition duration_seconds: anyOf: - type: integer - type: 'null' description: Duration seconds returned by the Sendora API. title: Duration Seconds ended_at: anyOf: - type: string - type: 'null' description: Ended at returned by the Sendora API. title: Ended At id: description: The call's id. Pass it to Get call details. title: Id type: string lead_id: anyOf: - type: string - type: 'null' description: 'The lead that was called: an `id` from List all leads.' title: Lead Id recording_ref: anyOf: - type: string - type: 'null' description: Recording ref returned by the Sendora API. title: Recording Ref started_at: anyOf: - type: string - type: 'null' description: Started at returned by the Sendora API. title: Started At required: - id title: CallOut type: object ValidationError: properties: loc: description: Loc returned by the Sendora API. items: anyOf: - type: string - type: integer title: Location type: array msg: description: Msg returned by the Sendora API. title: Message type: string type: description: Type returned by the Sendora API. title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: ApiKeyAuth: description: Customer API key created in the Sendora dashboard. in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.