> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowapt.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Call > One call with every event FlowIQ recorded for it. Scope: read. One call: the [call object](https://docs.flowapt.com/flowiq-api-reference/calling.md#the-call-object) plus `events`, everything FlowIQ recorded for it in order. While the call is still ringing it also carries `session`, WhatsApp's SDP offer, for a server that missed the webhook. ## Basic Usage ```bash theme={null} CALL_ID=$(node -e 'console.log(encodeURIComponent(process.argv[1]))' "wacid.HBgLMjc4MjAwMDAwMDAVAgARGBI2RjQ3QkU1RjA5Q0UyMkEzQjQA") curl "https://api.flowiq.live/v1/calls/$CALL_ID" \ -H "Authorization: Bearer fiq_YOUR_API_KEY" ``` *** ## Path Parameters | Parameter | Type | Required | Description | | - | - | - | - | | `call_id` | string | Yes | The call's id, URL-encoded (ids contain `=` and can contain `/`) | *** ## Response ### Success (200) ```json theme={null} { "organization_id": "a4234f32-…", "data": { "id": "wacid.HBgLMjc4MjAwMDAwMDAVAgARGBI2RjQ3QkU1RjA5Q0UyMkEzQjQA", "channel": "whatsapp", "direction": "inbound", "status": "completed", "answered_by": "inbox", "started_at": "2026-10-26T20:48:04.097Z", "answered_at": "2026-10-26T20:48:41.000Z", "ended_at": "2026-10-26T20:49:51.000Z", "duration_seconds": 70, "end_reason": "completed", "transcript": null, "has_recording": true, "recording_url": "https://auth.flowiq.live/storage/v1/object/sign/call-recordings/…", "contact": { "id": "9b8a7c6d-…", "whatsapp_id": "27820000000", "name": "Jane Doe" }, "events": [ { "type": "ringing", "at": "2026-10-26T20:48:04.097Z" }, { "type": "answered", "at": "2026-10-26T20:48:41.947Z" }, { "type": "ended", "at": "2026-10-26T20:49:53.018Z", "status": "COMPLETED" } ] } } ``` *** A call id that is not on your number answers `404` `Call not found`. ## OpenAPI ````yaml flowiq-api-reference/openapi-calls.json GET /v1/calls/{call_id} openapi: 3.1.0 info: title: FlowIQ Calling API version: 1.0.0 description: >- Run WhatsApp calls on your FlowIQ number from your own server: answer, decline, end and start calls, ask for call permission, read call history and change the number's calling settings. Every response carries X-Request-Id; errors carry a stable code; POST / PATCH accept Idempotency-Key. servers: - url: https://api.flowiq.live description: FlowIQ Production API security: - BearerAuth: [] paths: /v1/calls/{call_id}: get: tags: - Calling summary: Get Call description: 'One call with every event FlowIQ recorded for it. Scope: read.' operationId: getCall parameters: - name: call_id in: path required: true description: The call's id, URL-encoded schema: type: string responses: '200': description: Success content: application/json: schema: type: object properties: organization_id: type: string format: uuid data: $ref: '#/components/schemas/CallDetail' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' '429': $ref: '#/components/responses/RateLimited' components: schemas: CallDetail: allOf: - $ref: '#/components/schemas/Call' - type: object properties: events: type: array items: type: object properties: type: type: string enum: - ringing - pre_accepted - answered - rejected - ended - event at: type: string format: date-time status: type: string via: type: string enum: - api - inbox session: type: object description: >- Only while the call is still ringing: WhatsApp's SDP offer, for a server that missed the webhook properties: sdp_type: type: string enum: - offer sdp: type: string Error: type: object properties: error: type: string description: Short label (Bad request, Not found, …) code: type: string description: Stable machine-readable code, see Conventions message: type: string request_id: type: string format: uuid description: Quote this to support whatsapp_error_code: type: integer description: WhatsApp's own code, on whatsapp_rejected Call: type: object properties: id: type: string description: >- WhatsApp's call id (starts with wacid.). URL-encode it when it goes in a path example: wacid.HBgLMjc4MjAwMDAwMDAVAgARGBI2RjQ3QkU1RjA5Q0UyMkEzQjQA channel: type: string enum: - whatsapp - phone description: >- whatsapp = WhatsApp call; phone = a call to a FlowIQ phone line (read only here) direction: type: string enum: - inbound - outbound status: type: string enum: - ringing - in_progress - completed - missed - rejected - failed answered_by: type: - string - 'null' enum: - api - stream - flowiq_ai - inbox - null description: >- Who picked up: your server (accept with an SDP answer), your server through the media stream, FlowIQ's voice AI, or a person in the FlowIQ inbox. null while nobody has started_at: type: string format: date-time answered_at: type: - string - 'null' format: date-time ended_at: type: - string - 'null' format: date-time duration_seconds: type: - integer - 'null' example: 70 end_reason: type: - string - 'null' example: completed transcript: type: - string - 'null' description: >- Present when FlowIQ's voice AI answered, or a recording was transcribed has_recording: type: boolean recording_url: type: - string - 'null' description: Signed link to the recording, valid for 1 hour contact: type: - object - 'null' properties: id: type: string format: uuid description: FlowIQ contact id whatsapp_id: type: string description: WhatsApp number, digits only, with country code example: '27820000000' name: type: - string - 'null' example: Jane Doe from: type: - string - 'null' description: >- The caller's number (customer on inbound calls, your number on outbound) to: type: - string - 'null' biz_opaque_callback_data: type: - string - 'null' description: Your reference from accept / start, when you set one responses: BadRequest: description: Invalid request, or WhatsApp refused it (the message says why) content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Request failed message: Parameter value is not valid Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: The key lacks the scope, or the person has not given call permission content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Request failed message: Contact has not granted callback permission RateLimited: description: 240 reads or 60 actions per minute per key; Retry-After says when content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: fiq_ API key description: >- Your FlowIQ organisation API key (Settings → API Keys), sent as a bearer token. Format: `Bearer fiq_YOUR_API_KEY` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.