> ## Documentation Index > Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Call ## OpenAPI ````yaml latest.yml GET /agents/calls/{call_id} openapi: 3.0.1 info: title: Cartesia API version: 0.0.1 servers: - url: https://api.cartesia.ai description: Production security: [] paths: /agents/calls/{call_id}: get: tags: - Agents summary: Get Call operationId: agents_get-call parameters: - $ref: '#/components/parameters/CartesiaVersionHeader' - name: call_id in: path description: The ID of the call. required: true schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/AgentCall' security: - APIKeyAuth: [] components: parameters: CartesiaVersionHeader: name: Cartesia-Version in: header description: API version header. required: true schema: type: string format: date example: '2026-08-14' default: '2026-08-14' enum: - '2026-08-14' schemas: AgentCall: title: AgentCall type: object properties: id: type: string description: The unique identifier for the agent call. agent_id: type: string description: The identifier of the agent associated with the call. agent_name: type: string description: The name of the agent associated with the call. start_time: type: string format: date-time nullable: true description: The start time of the agent call. end_time: type: string format: date-time nullable: true description: The end time of the agent call. redacted_at: type: string format: date-time nullable: true description: >- When the call's sensitive data was deleted, if it has been. Set by `DELETE /agents/calls/{call_id}`; deleted fields are omitted from responses. transcript: type: array items: $ref: '#/components/schemas/AgentTranscript' nullable: true description: The transcript of the agent call. telephony_params: $ref: '#/components/schemas/TelephonyParams' nullable: true description: >- The telephony parameters associated with the call when the call is made via phone. telephony_account_type: type: string enum: - cartesia - twilio - sip_trunk nullable: true description: >- The telephony account type backing the call. `cartesia` is the default Cartesia-hosted path; `twilio` indicates a customer-owned Twilio subaccount; `sip_trunk` indicates a customer-connected SIP trunk. summary: type: string nullable: true description: >- A summary of the agent call. This is a brief summary of the call that is generated by Cartesia. status: $ref: '#/components/schemas/AgentCallStatus' description: The status of the agent call. error_message: type: string nullable: true description: The error message, if any, associated with the call. end_reason: $ref: '#/components/schemas/EndReason' nullable: true description: The reason why the call ended. metadata: type: object additionalProperties: true nullable: true description: Custom metadata associated with the call. required: - id - agent_id - status AgentTranscript: title: AgentTranscript type: object properties: role: type: string description: >- The role of the participant in the conversation. Roles are `user`, `assistant`, or `system`. `assistant` is the agent. text: type: string nullable: true description: >- The text content of the transcript. This is the text that was spoken by the user or the agent. start_timestamp: type: number format: float description: The start timestamp in seconds relative to the start of the call. end_timestamp: type: number format: float description: The end timestamp in seconds relative to the start of the call. tool_calls: type: array items: $ref: '#/components/schemas/ToolCall' nullable: true description: The tool calls made during the turn. stt_ttfb: type: number format: float nullable: true description: The time to first byte in seconds for speech-to-text. tts_ttfb: type: number format: float nullable: true description: The time to first byte in seconds from the agent for text-to-speech. required: - role - start_timestamp - end_timestamp TelephonyParams: title: TelephonyParams type: object description: >- The telephony parameters associated with the call when the call is made via a phone. More details can also be returned depending on the provider. properties: to: type: string description: >- The phone number of the caller. Present for phone calls; omitted for websocket connections. from: type: string description: >- The phone number of the agent. Present for phone calls; omitted for websocket connections. call_sid: type: string description: The SID of the telephony call from the provider. direction: type: string description: The direction of the call, e.g., `inbound` or `outbound`. parameters: type: object additionalProperties: type: string description: Additional parameters associated with the telephony call. headers: type: object additionalProperties: type: string description: Additional headers associated with the telephony call. connection_type: type: string enum: - websocket - phone description: The type of connection used for the call. AgentCallStatus: title: AgentCallStatus type: string enum: - created - started - completed - failed description: The status of an agent call. EndReason: title: EndReason type: string enum: - agent_hangup - client_hangup - api_cancelled - max_duration - inactivity - client_disconnected - dial_busy - dial_failed - dial_no_answer - error description: A machine-readable enum indicating why a call ended. ToolCall: title: ToolCall type: object properties: id: type: string description: The unique identifier for the tool call. name: type: string description: The name of the tool that was called. arguments: type: object additionalProperties: true description: The arguments passed to the tool. result: type: string description: The result returned by the tool. required: - name - arguments securitySchemes: APIKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- Cartesia API key (`sk_car_...`). Get one at [play.cartesia.ai/keys](https://play.cartesia.ai/keys). x-default: $CARTESIA_API_KEY ````