> ## Documentation Index > Fetch the complete documentation index at: https://docs.powerdialer.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a call > Fetch the latest call state after an event or when displaying a conversation in your integration. Requires `calls:read`. The path identifier is the `callSid` string, not the numeric `id` returned in collection rows. Access remains limited to the key's workspace and permitted owners. The response includes disposition, talk time, original list attribution and permitted evidence. Add `recordings:read` or `transcripts:read` to receive their contents; otherwise the respective state is `restricted`. With permission, `unavailable` can mean delayed, uncaptured or removed evidence. Re-fetch after evidence-ready events. Also handle `call.disposition_updated`: disposition-only edits do not advance the call’s `updatedAt` field. `404 not_found` deliberately covers missing, inaccessible and unattributed calls. A malformed identifier returns `400 invalid_request`. A recording marked available is a stored reference, not a playback guarantee; its URL can still be null. This read can be retried after transient failures without an idempotency key. See [evidence handling](/guides/call-evidence#delayed-or-restricted-evidence). ## OpenAPI ````yaml /api/openapi.json get /calls/{id} openapi: 3.1.0 info: title: PowerDialer API v2 version: 2.0.0 description: >- Connect your CRM, sales workspace or reporting tools to PowerDialer using scoped API keys. Manage contacts and calling lists, read call evidence and analytics, and receive signed events. All example records and IDs are synthetic; replace them with values from your workspace. Shared-key v1 is retired. API availability was verified on 2026-10-08; see /availability for historical data coverage. Legacy outbound webhooks use a separate contract. servers: - url: https://api.migration.powerdialer.ai/api/public/v2 description: Production API v2; availability verified on 2026-10-08. security: - ApiKey: [] tags: - name: Authentication - name: Contacts - name: Calling lists - name: Imports - name: Calls - name: Synchronization - name: Analytics - name: Webhooks - name: Webhook deliveries - name: Incoming webhook payloads paths: /calls/{id}: get: tags: - Calls summary: Get a call description: >- Fetch the latest call state after an event or when displaying a conversation in your integration. Requires `calls:read`. The path identifier is the `callSid` string, not the numeric `id` returned in collection rows. Access remains limited to the key's workspace and permitted owners. The response includes disposition, talk time, original list attribution and permitted evidence. Add `recordings:read` or `transcripts:read` to receive their contents; otherwise the respective state is `restricted`. With permission, `unavailable` can mean delayed, uncaptured or removed evidence. Re-fetch after evidence-ready events. Also handle `call.disposition_updated`: disposition-only edits do not advance the call’s `updatedAt` field. `404 not_found` deliberately covers missing, inaccessible and unattributed calls. A malformed identifier returns `400 invalid_request`. A recording marked available is a stored reference, not a playback guarantee; its URL can still be null. This read can be retried after transient failures without an idempotency key. See [evidence handling](/guides/call-evidence#delayed-or-restricted-evidence). operationId: getCallsById parameters: - name: id in: path required: true schema: type: string minLength: 1 maxLength: 200 description: >- The callSid string from call history or a call event resourceId. This is not the numeric call row ID. Accepts 1–200 characters. example: call_example_789 responses: '200': description: >- Current visible call state, including only the evidence the credential can read. headers: X-Request-Id: schema: type: string format: uuid RateLimit-Limit: schema: type: integer RateLimit-Remaining: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Call' example: id: 789 callSid: call_example_789 ownerId: user_example createdAt: '2026-10-07T12:00:00.000Z' updatedAt: '2026-10-07T12:00:00.000Z' contactId: 123 contactName: Alex Morgan phoneNumber: '+12125550100' fromPhoneNumber: '+12125550101' direction: outbound callStatus: Conversation disposition: type: Interested notes: Requested a follow-up. listId: 456 talkTimeSeconds: 150 recording: state: restricted transcript: state: restricted default: description: >- Error. 400 invalid request; 401 invalid credential; 403 insufficient access; 404 not found; 409 state/idempotency conflict; 413 size limit; 422 verification failure; 429 rate limit (Retry-After seconds); 503 temporary service failure. headers: Retry-After: schema: type: integer X-Request-Id: schema: type: string format: uuid content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_api_key message: API key is invalid, expired or revoked requestId: 00000000-0000-4000-8000-000000000004 x-codeSamples: - lang: bash label: cURL source: >- # Replace example resource IDs and ownerId with values from your workspace. : "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}" curl --request GET \ --url 'https://api.migration.powerdialer.ai/api/public/v2/calls/call_example_789' \ --header "Authorization: Bearer $POWERDIALER_API_KEY" components: schemas: Call: type: object properties: id: type: integer description: >- Internal numeric row ID used for pagination. Use callSid, not this field, in GET /calls/{id}. callSid: type: string description: Call identifier used in GET /calls/{id} and call events. ownerId: type: string description: PowerDialer member attributed to the call. createdAt: type: string format: date-time description: Call record creation time in UTC. Used by the from/to filter. updatedAt: type: string format: date-time description: Last API-visible update time in UTC. contactId: anyOf: - type: integer - type: 'null' description: Related contact ID, or null. contactName: anyOf: - type: string - type: 'null' description: Contact name recorded for the call, or null. phoneNumber: type: string description: Destination phone number recorded for the call. fromPhoneNumber: type: string description: Originating phone number recorded for the call. direction: anyOf: - type: string - type: 'null' description: Stored call direction, or null when absent. callStatus: type: string description: >- Stored call outcome or status. Do not treat this field alone as a verified sales conversion. disposition: anyOf: - type: object properties: type: type: string notes: type: string required: - type - notes - type: 'null' description: Recorded disposition type and notes, or null. listId: anyOf: - type: integer - type: 'null' description: Calling-list ID from the call session, or null. talkTimeSeconds: type: number description: >- Talk duration in seconds, using provider duration when present and recorded call duration otherwise. May be fractional. recording: $ref: '#/components/schemas/Recording' description: >- Recording availability. Requires recordings:read in addition to calls:read. transcript: $ref: '#/components/schemas/Transcript' description: >- Transcript availability and speaker/text segments. Requires transcripts:read in addition to calls:read. required: - id - callSid - ownerId - createdAt - updatedAt - contactId - contactName - phoneNumber - fromPhoneNumber - direction - callStatus - disposition - listId - talkTimeSeconds - recording - transcript examples: - id: 789 callSid: call_example_789 ownerId: user_example createdAt: '2026-10-07T12:00:00.000Z' updatedAt: '2026-10-07T12:00:00.000Z' contactId: 123 contactName: Alex Morgan phoneNumber: '+12125550100' fromPhoneNumber: '+12125550101' direction: outbound callStatus: Conversation disposition: type: Interested notes: Requested a follow-up. listId: 456 talkTimeSeconds: 150 recording: state: restricted transcript: state: restricted Error: type: object properties: error: type: object properties: code: type: string description: Stable machine-readable error code. message: type: string description: Human-readable explanation. requestId: type: string format: uuid description: Request identifier to include when investigating a failure. details: type: array items: type: object properties: path: type: string message: type: string required: - path - message description: Validation errors, when available. required: - code - message - requestId required: - error examples: - error: code: insufficient_scope message: Requires contacts:read requestId: 00000000-0000-4000-8000-000000000004 Recording: oneOf: - type: object properties: state: type: string enum: - restricted required: - state - type: object properties: state: type: string enum: - available - unavailable url: anyOf: - type: string - type: 'null' required: - state - url description: >- Without recordings:read, only state=restricted is returned. With that permission, available/unavailable indicates stored recording evidence; url can still be null when no usable URL can be resolved. examples: - state: available url: https://recordings.example.com/example-call.mp3 Transcript: oneOf: - type: object properties: state: type: string enum: - restricted required: - state - type: object properties: state: type: string enum: - available - unavailable segments: type: array items: type: object properties: speaker: type: string text: type: string required: - speaker - text required: - state - segments description: >- Without transcripts:read, only state=restricted is returned. With that permission, available means parsed segments exist; unavailable returns an empty segments array. examples: - state: available segments: - speaker: agent text: Is this a good time to talk? - speaker: customer text: Yes, I have a few minutes. securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: pd__. description: >- Issued in Developers. Workspace/owner/scopes come from credential, never acting-user headers. API keys cannot manage API credentials. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.