--- title: "Calls.get" method: GET path: "/entities/Calls/{id}" tags: ["Call"] --- # Calls.get `GET /entities/Calls/{id}` ## Request - Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id` - URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/Calls/{id}` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns the Call record with the given id. ## Path parameters - `id` string, uuid, required ## Query parameters - `expand` string ## Response `200` The Call record. - object - `success` boolean: True when the request succeeded; false on error. - `data` Call: Phone call logged in the space, linked to the user who made it and to the contact, account, lead or opportunity it concerns. - `is_delete_protected` boolean, required: True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only. - `id` string, uuid, required: Unique identifier of entity. - `is_deleted` boolean: Specifies if the entity is considered deleted. - `modified` string, date-time: Last modification time. - `created` string, date-time: Creation time. - `account` string, uri: Account the call is linked to, when applicable. Related Account record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Account' for its fields. - `caller` string, uri, required: User who initiated the call. Related Client record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Client' for its fields. - `client` string, uri: User the call was made with, when the call was an internal user-to-user call. Related Client record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Client' for its fields. - `contact` string, uri: Contact the call is linked to, when applicable. Related Contact record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Contact' for its fields. - `lead` string, uri: Lead the call is linked to, when the call is associated with a lead. Related Lead record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Lead' for its fields. - `oppty` string, uri: Opportunity the call is linked to, when the call is associated with an opportunity. Related Opportunity record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Opportunity' for its fields. - `oppty_product_relation` string, uri: Specific opportunity line-item discussed on the call, when applicable. Related OpptyProductRelation record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'OpptyProductRelation' for its fields. - `product` string, uri: Product discussed on the call, when applicable. Related Product record, returned as the URI of the record. With the 'expand' parameter the full record is returned instead; see 'Product' for its fields. - `account_id` string, uuid: Id of the linked account. - `caller_id` string, uuid, required: Id of the calling user. - `client_id` string, uuid: Id of the user the call was made with. - `contact_id` string, uuid: Id of the linked contact. - `lead_oppty_id` string, uuid: Id of the linked lead or opportunity, or empty when not linked. - `oppty_product_relation_id` string, uuid: Id of the linked opportunity product line-item. - `phone_number` string: External phone number called or received, in E.164 format. - `product_id` string, uuid: Id of the linked product. - `transcription_id` string: External transcription identifier from the calling provider. - `transcription_language` string: Language requested for the transcription as a BCP-47 locale tag (e.g. "en-US"). - `transcription_summary` string: AI-generated summary of the call transcription. - `twilio_call_log_id` string, uuid, required: Id of the call-log record from the calling provider that this call is associated with. - `transcription_file_id` string, uuid: Id of the cloud object holding the transcription payload, when available. - `audio_id` string, uuid: Id of the cloud object holding the call audio recording, when available. - `twilio_call_sid` string, required: External call identifier from the calling provider (e.g. Twilio Call SID). - `audio_status` 'NoRecording' | 'TranscriptionCompleted' | 'TranscriptionEmpty' | 'TranscriptionError' | 'TranscriptionInProgress' | 'UploadError' | 'Uploaded' | 'Uploading', required: Recording and transcription status of the call, computed by the server. The only accepted inputs are Uploading on create, to announce that a recording will be uploaded, and NoRecording on update, to mark that the call has no recording. ## Other responses - `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`. - `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED). - `404`: No such record or entity (code 143 ERROR_NO_ENTITY, or 2006 ERROR_UNKNOWN_TYPE). - `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry. - `500`: Unexpected server error (code 1000, ERROR_UNKNOWN). --- [API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)