---
title: "Get call recording by name"
method: GET
path: "/calls/{id}/recordings/{name}"
tags: ["calls"]
---

# Get call recording by name

`GET /calls/{id}/recordings/{name}`

Returns recording metadata of particular call. Metadata contains link to a MP3 recording

## Path parameters

- `id` integer, required
- `name` string, required

## Query parameters

- `fields` string

## Response `200`

successful operation

- CallRecording — Represents a recording of a voice call
  - `id` integer — An id of a call recording
  - `callId` integer — An id of a call action
  - `campaignId` integer — Contains broadcast id if call was sent as a part of voice broadcast
  - `name` string — A name of a recording
  - `created` integer — The time when the given resource was created, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
  - `lengthInBytes` integer — A size of a recording file in bytes
  - `lengthInSeconds` integer — Duration of a recording in seconds
  - `hash` string — A unique string hash identifier of a recording
  - `mp3Url` string — A public URL of a call recording
  - `state` 'RECORDING' | 'READY' | 'ERROR' — Current state of a recording, available values: RECORDING - recording is in progress, READY - recording is ready, ERROR - error has occurred and recording can be broken

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.net/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/versions/9f6fb501bc03/schema)