> ## Documentation Index > Fetch the complete documentation index at: https://docs.poly.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get audio recording for a conversation > Fetch the WAV audio recording for a conversation. Served from api.{region}.poly.ai. Users without PII access automatically receive the redacted recording. ## 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](/tools/classes/conv-log#pii) 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 ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} 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 | ## OpenAPI ````yaml GET /v1/agents/{agentId}/conversations/{conversationId}/audio openapi: 3.0.1 info: title: PolyAI Conversations API v3 description: >- Query conversations, recordings, and debug chat for a PolyAI agent. Compared to v1, v3: - Exposes additional turn-level fields (latency, translated_user_input, english_agent_response). - Normalizes empty text fields as empty strings rather than null. license: name: MIT version: 3.0.0 servers: - url: https://api.us-1.platform.polyai.app description: US base url - url: https://api.uk-1.platform.polyai.app description: UK base url - url: https://api.euw-1.platform.polyai.app description: EUW base url security: - ApiKeyAuth: [] tags: - name: Conversations description: Query conversations and audio recordings. - name: Debug Chat description: Create and respond to debug chat sessions for testing an agent. paths: /v1/agents/{agentId}/conversations/{conversationId}/audio: get: tags: - Conversations summary: Get audio recording for a conversation description: >- Returns the audio recording for a conversation as a WAV file. **Host:** this endpoint is served from `api.{region}.poly.ai` — *not* the `api.{region}-1.platform.polyai.app` host used by the list-conversations endpoint. **PII access enforcement.** Users without PII access always receive the redacted recording, regardless of the `redacted` query parameter. Users with PII access receive the raw recording by default and can opt into the redacted version by passing `redacted=true`. PII access is granted through your account's role and permission configuration in Agent Studio. parameters: - name: agentId in: path description: Agent ID. required: true schema: type: string - name: conversationId in: path description: Unique conversation ID. required: true schema: type: string example: CAabcd1234567abcdef1250065d4fc7389 - name: direction in: query description: >- 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. required: false schema: type: string enum: - combined - user - agent default: combined - name: redacted in: query description: >- 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.** required: false schema: type: boolean default: false responses: '200': description: WAV audio recording for the conversation. content: audio/wav: schema: type: string format: binary '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Unauthorized' '404': description: Recording not found for the given conversation. content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/InternalError' servers: - url: https://api.us.poly.ai description: US base url - url: https://api.eu.poly.ai description: EU base url - url: https://api.uk.poly.ai description: UK base url - url: https://api.studio.poly.ai description: Studio base url components: responses: BadRequest: description: Bad Request. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/Error' InternalError: description: Internal Server Error. content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object properties: error_message: description: Reason for error. type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Contact your PolyAI representative. ````