# 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.
 - [GET /calls/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/showcall.md): Retrieve a single call by id.
 - [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.
 - [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 downloadable text file.
 - [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 source
 - [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.
 - [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.
 - [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.
 - [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.
 - [Call](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls/call.md): Schema: #/components/schemas/call
