> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt # get > Retrieve a single call by SID. Retrieve a single call by SID. ### Schema ```yaml openapi: 3.1.0 info: title: API version: 1.0.0 paths: /Accounts/{AccountSid}/Calls/{Sid}: get: operationId: retrieve_a_call summary: Retrieve a Call description: >- Retrieve a call. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). tags: - subpackage_calls parameters: - name: AccountSid in: path description: The Project ID that uniquely identifies the Account. required: true schema: $ref: '#/components/schemas/uuid' - name: Sid in: path description: The unique identifier for the call. required: true schema: $ref: '#/components/schemas/uuid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CallResponse' '400': description: >- The request was invalid or cannot be processed. Check the error details for more information. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '401': description: Authentication failed. Please verify your credentials and try again. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' '404': description: >- The requested resource was not found. Please verify the resource identifier. content: application/json: schema: $ref: '#/components/schemas/CompatibilityErrorResponse' servers: - url: https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01 description: SignalWire Compatibility API components: schemas: uuid: type: string format: uuid description: Universal Unique Identifier. title: uuid CallStatus: type: string enum: - queued - ringing - in-progress - canceled - completed - busy - failed - no-answer description: Call status. title: CallStatus CallDirection: type: string enum: - inbound - outbound description: Call direction. title: CallDirection AnsweredBy: type: string enum: - human - machine description: Who/what answered the call. title: AnsweredBy CallSubresourceUris: type: object properties: notifications: type: - string - 'null' description: The URI for notifications. Always null. recordings: type: string description: The URI for recordings. required: - notifications - recordings description: Call subresource URIs. title: CallSubresourceUris CallResponse: type: object properties: sid: $ref: '#/components/schemas/uuid' description: The unique identifier for the call. account_sid: $ref: '#/components/schemas/uuid' description: The unique identifier for the account that created this call. date_created: type: string description: The date, in RFC 2822 GMT format, this call was created. date_updated: type: string description: The date, in RFC 2822 GMT format, this call was updated. parent_call_sid: oneOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the call that created this call. to: type: string description: The address that received the call. formatted_to: type: string description: The formatted number that received the call. to_formatted: type: string description: The formatted number that received the call. Alias for formatted_to. from: type: string description: The address that initiated the call. formatted_from: type: string description: The formatted number that initiated the call. from_formatted: type: string description: >- The formatted number that initiated the call. Alias for formatted_from. phone_number_sid: oneOf: - $ref: '#/components/schemas/uuid' - type: 'null' description: The unique identifier for the phone number. status: $ref: '#/components/schemas/CallStatus' description: The status of the call. start_time: type: - string - 'null' description: The time, in RFC 2822 GMT format, on which the call began. end_time: type: - string - 'null' description: The time, in RFC 2822 GMT format, on which the call was terminated. duration: type: integer description: The duration, in seconds, of the call. price: type: - string - 'null' title: float description: The charge for the call. price_unit: type: string description: The currency, in ISO 4127 format, for the price of the call. direction: $ref: '#/components/schemas/CallDirection' description: The direction of the call. answered_by: oneOf: - $ref: '#/components/schemas/AnsweredBy' - type: 'null' description: Who/what the call was answered by. api_version: type: string description: The version of the SignalWire API. forwarded_from: type: - string - 'null' description: The number this call was forwarded from. Always null. caller_name: type: - string - 'null' description: The caller name. Always null. uri: type: string description: The URI for the call. subresource_uris: $ref: '#/components/schemas/CallSubresourceUris' description: A Map of available sub-resources. annotation: type: - string - 'null' description: The annotation for the call. Always null. group_sid: type: - string - 'null' description: The group SID for the call. Always null. audio_in_mos: type: - string - 'null' title: float description: The Mean Opinion Score for audio quality (1.0-5.0). sip_result_code: type: - string - 'null' description: The SIP result code for the call. audio_rtt_avg: type: - integer - 'null' description: The average round-trip time for audio in milliseconds. audio_rtt_min: type: - integer - 'null' description: The minimum round-trip time for audio in milliseconds. audio_rtt_max: type: - integer - 'null' description: The maximum round-trip time for audio in milliseconds. audio_out_jitter_min: type: - integer - 'null' description: The minimum outbound audio jitter in milliseconds. audio_out_jitter_max: type: - integer - 'null' description: The maximum outbound audio jitter in milliseconds. audio_out_jitter_avg: type: - integer - 'null' description: The average outbound audio jitter in milliseconds. audio_out_lost: type: - integer - 'null' description: The number of outbound audio packets lost. required: - sid - account_sid - date_created - date_updated - parent_call_sid - to - formatted_to - to_formatted - from - formatted_from - from_formatted - phone_number_sid - status - start_time - end_time - duration - price - price_unit - direction - answered_by - api_version - forwarded_from - caller_name - uri - subresource_uris - annotation - group_sid - audio_in_mos - sip_result_code - audio_rtt_avg - audio_rtt_min - audio_rtt_max - audio_out_jitter_min - audio_out_jitter_max - audio_out_jitter_avg - audio_out_lost description: Response containing a single call. title: CallResponse CompatibilityErrorResponse: type: object properties: code: type: integer description: Error code. message: type: string description: Error message. more_info: type: string description: URL for more information about the error. status: type: integer description: HTTP status code. required: - code - message - more_info - status description: Error response model. title: CompatibilityErrorResponse ``` ## **Response Example** ### Response (200) ```json { "sid": "b3877c40-da60-4998-90ad-b792e98472ca", "account_sid": "b3877c40-da60-4998-90ad-b792e98472af", "date_created": "Wed, 19 Sep 2018 20:00:00 +0000", "date_updated": "Wed, 19 Sep 2018 21:00:00 +0000", "parent_call_sid": "b3877c40-da60-4998-90ad-b792e98472af", "to": "+13105678901", "formatted_to": "(310) 567-8901", "to_formatted": "(310) 567-8901", "from": "+13103384645", "formatted_from": "(310) 338-4645", "from_formatted": "(310) 338-4645", "phone_number_sid": "b3877c40-da60-4998-90ad-b792e98472pn", "status": "queued", "start_time": "Wed, 19 Sep 2018 20:00:01 +0000", "end_time": "Fri, 21 Sep 2018 10:00:00 +0000", "duration": 20, "price": 0.003, "price_unit": "USD", "direction": "inbound", "answered_by": "human", "api_version": "2010-04-01", "forwarded_from": null, "caller_name": null, "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca.json", "subresource_uris": { "notifications": null, "recordings": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Calls/b3877c40-da60-4998-90ad-b792e98472ca/Recordings.json" }, "annotation": null, "group_sid": null, "audio_in_mos": 4.5, "sip_result_code": "200", "audio_rtt_avg": 50, "audio_rtt_min": 20, "audio_rtt_max": 100, "audio_out_jitter_min": 1, "audio_out_jitter_max": 10, "audio_out_jitter_avg": 5, "audio_out_lost": 0 } ``` ## **Example** ```python {9} from signalwire.rest import RestClient client = RestClient( project="your-project-id", token="your-api-token", host="your-space.signalwire.com", ) call = client.compat.calls.get("CA...") ```