> ## Documentation Index
> Fetch the complete documentation index at: https://polyai-mintlify-665e356f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get conversation audio

> Fetch the WAV audio recording for a conversation. 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.

## Example

```bash theme={null}
curl --request GET \
  --url "https://api.us-1.platform.polyai.app/v3/{account_id}/{project_id}/conversations/{conversation_id}/audio?direction=combined&redacted=false" \
  --header "x-api-key: $POLYAI_API_KEY" \
  --output conversation.wav
```


## OpenAPI

````yaml GET /v3/{account_id}/{project_id}/conversations/{conversation_id}/audio
openapi: 3.0.1
info:
  title: PolyAI Conversations API v3
  description: >-
    Schema for the PolyAI Conversations API v3.


    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: []
paths:
  /v3/{account_id}/{project_id}/conversations/{conversation_id}/audio:
    get:
      summary: Get audio recording for a conversation
      description: >-
        Returns the audio recording for a conversation as a WAV file.


        **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: account_id
          in: path
          description: Account ID.
          required: true
          schema:
            type: string
        - name: project_id
          in: path
          description: Project ID.
          required: true
          schema:
            type: string
        - name: conversation_id
          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'
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.

````