Get audio recording for a conversation

GET

agents

{agentId}

conversations

{conversationId}

audio

Get audio recording for a conversation

curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

"<string>"

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

PII access and redaction

The redacted query parameter controls whether personally identifiable information (PII) is muted from the returned audio:

User PII access	`redacted` query value	Audio returned
Yes	`false` (or omitted)	Raw recording
Yes	`true`	Redacted recording
No	`false` (or omitted)	Redacted recording (enforced)
No	`true`	Redacted recording

Users without PII access always receive the redacted recording, even when redacted=false is passed. This is enforced server-side, so callers cannot bypass redaction by omitting or overriding the query parameter. PII access is granted through your account’s role and permission configuration in Agent Studio. See PII logging for related conversation-log behavior.

Regional base URLs

Region	Base URL
US	`https://api.us.poly.ai`
EU	`https://api.eu.poly.ai`
UK	`https://api.uk.poly.ai`
Studio	`https://api.studio.poly.ai`

This endpoint is served from the Kong-routed host (api.{region}.poly.ai), not api.{region}-1.platform.polyai.app (which serves the list-conversations endpoint). Sending the request to the wrong host will fail.

Example

curl --request GET \
  --url "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio?direction=combined&redacted=false" \
  --header "x-api-key: $POLYAI_API_KEY" \
  --output conversation.wav

Replace {agentId} and {conversationId} with real values — the placeholders are not resolved server-side. Only Accept: audio/wav is needed; do not send Content-Type on this GET request (it has no body).

Common pitfalls

Symptom	Likely cause	Fix
`404 Not Found` or DNS error	Using the wrong host (e.g. `api.us-1.platform.polyai.app`)	Use `api.{region}.poly.ai`
`404 Not Found` on the conversation	The literal string `{conversationId}` was left in the URL	Substitute a real conversation ID from the List Conversations endpoint
`401 Unauthorized`	Empty or wrong-region API key	Issue a region-scoped key from PolyAI

Authorizations

x-api-key

string

header

required

Contact your PolyAI representative.

Path Parameters

agentId

string

required

Agent ID.

conversationId

string

required

Unique conversation ID.

Query Parameters

direction

enum<string>

default:combined

Which side of the call to return. combined returns the full mixed recording. user returns only the caller audio. agent returns only the agent audio.

Available options:

combined,

user,

agent

redacted

boolean

default:false

If true, returns the redacted recording with personally identifiable information (PII) muted. If false, returns the raw recording. Users without PII access always receive the redacted recording, regardless of this parameter.

Response

WAV audio recording for the conversation.

The response is of type file.

Last modified on May 29, 2026

OverviewReserve dynamic phone numbers with attached context for marketing, CRM, and web-to-call integrations.

⌘I

Get audio recording for a conversation

curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

"<string>"

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

{
  "success": false,
  "error": "<string>",
  "error_id": "<string>",
  "error_code": "<string>",
  "error_message": "<string>",
  "data": "<unknown>"
}

API reference

Build & deploy

Runtime & data

Monitoring

Legacy

Get audio recording for a conversation

PII access and redaction

Regional base URLs

Example

Common pitfalls

Authorizations

Path Parameters

Query Parameters

Response

​PII access and redaction

​Regional base URLs

​Example

​Common pitfalls

Authorizations

Path Parameters

Query Parameters

Response

PII access and redaction

Regional base URLs

Example

Common pitfalls