# Calls

Everything about your Calls

 - [GET /calls](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/listcalls.md): Retrieve a paginated list of calls. Requires the `read_conversations` OAuth scope.
 - [GET /calls/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/showcall.md): Retrieve a single call by id. Requires the `read_conversations` OAuth scope.
 - [GET /calls/{id}/recording](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/showcallrecording.md): Redirects to a signed URL for the call's recording if it exists. Requires the `read_conversations` OAuth scope.
 - [GET /calls/{id}/transcript](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/showcalltranscript.md): Returns the transcript for the specified call as a JSON array of turns. Each turn carries a `speaker_name` when the speaker could be resolved. Clients should fall back to `speaker_label` when `speaker
 - [POST /calls/search](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/listcallswithtranscripts.md): Retrieve calls by a list of conversation ids and include transcripts when available. A maximum of 20 `conversation_ids` can be provided. If none are provided or more than 20 are provided, a 400 error
 - [POST /fin_voice/register](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/registerfinvoicecall.md): Register a Fin Voice call with Intercom. This endpoint creates an external reference that links an external call identifier to an Intercom call and conversation. The call can be from different sources
 - [GET /fin_voice/collect/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/collectfinvoicecallbyid.md): Retrieve information about a Fin Voice call using the external reference ID. Requires the `read_conversations` OAuth scope.
 - [GET /fin_voice/external_id/{external_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/collectfinvoicecallbyexternalid.md): Retrieve information about a Fin Voice call using the external call identifier. Requires the `read_conversations` OAuth scope.
 - [GET /fin_voice/phone_number/{phone_number}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/collectfinvoicecallbyphonenumber.md): Retrieve information about a Fin Voice call using the phone number. Returns the most recent matched call for the given phone number, ordered by creation date. Requires the `read_conversations` OAuth s
 - [GET /fin_voice/conversation/{conversation_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/collectfinvoicecallsbyconversationid.md): Retrieve information about Fin Voice calls associated with a conversation. Returns all matched calls for the given conversation ID. A conversation may have multiple associated calls. Requires the `rea
 - [Call](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/call.md): Schema: #/components/schemas/call
 - [Call Transcript Turn](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/call_transcript_turn.md): Schema: #/components/schemas/call_transcript_turn