# Get redacted audio

Retrieve a signed URL for the PII-redacted version of the audio file. Only available when PII redaction was enabled during transcription creation.

Returns a time-limited signed URL to download the audio file with all detected PII (personally identifiable information) redacted. PII segments in the audio are replaced with silence or a tone.

The response status field indicates the availability of the redacted audio:

- **`available`** -- The redacted audio is ready. The `redacted_audio_url` and `expires_at` fields are populated.
- **`pending`** -- The redacted audio is still being generated. Retry after a short delay.
- **`not_enabled`** -- PII redaction was not enabled for this transcription. Re-create the transcription with `privacy_settings.pii_redaction_enabled: true` to enable it.


#### Path Parameters

**`transcription_id`** string required

The transcription ID with `trans_` prefix.

## Returns

Returns a success envelope with:

- **`data.transcription_id`** -- The transcription ID.
- **`data.status`** -- One of: `available`, `pending`, `not_enabled`.
- **`data.redacted_audio_url`** -- Signed URL to the redacted audio file (only present when status is `available`). The URL expires at the time indicated by `expires_at`.
- **`data.expires_at`** -- ISO 8601 timestamp when the signed URL expires (only present when status is `available`).
- **`metadata`** -- Request metadata: `request_id`, `timestamp`, `processing_time_ms`.


Request

```bash cURL
curl -s -X GET https://api.aitronos.com/v1/audio/transcribe/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6/redacted-audio \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

result = client.audio.get_redacted_audio(
    transcription_id="trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
)

if result.data.status == "available":
    print(f"Download URL: {result.data.redacted_audio_url}")
    print(f"Expires at: {result.data.expires_at}")
elif result.data.status == "pending":
    print("Redacted audio is still being generated. Try again later.")
else:
    print("PII redaction was not enabled for this transcription.")
```


```python Python
import requests

transcription_id = "trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
url = f"https://api.aitronos.com/v1/audio/transcribe/{transcription_id}/redacted-audio"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}

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

status = data["data"]["status"]
if status == "available":
    download_url = data["data"]["redacted_audio_url"]
    print(f"Download: {download_url}")
elif status == "pending":
    print("Still generating...")
else:
    print("PII redaction not enabled")
```


```javascript JavaScript
const accessToken = process.env.ACCESS_TOKEN;
const transcriptionId = 'trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6';

const response = await fetch(
  `https://api.aitronos.com/v1/audio/transcribe/${transcriptionId}/redacted-audio`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
    },
  }
);

const data = await response.json();
if (data.data.status === 'available') {
  console.log('Download URL:', data.data.redacted_audio_url);
} else {
  console.log('Status:', data.data.status);
}
```

Response

```json 200 OK (available)
{
  "success": true,
  "data": {
    "transcription_id": "trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "available",
    "redacted_audio_url": "https://storage.aitronos.com/redacted/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.mp3?token=xyz&expires=1709460000",
    "expires_at": "2026-03-03T12:00:00Z"
  },
  "metadata": {
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
    "timestamp": "2026-03-02T12:00:00Z",
    "processing_time_ms": 450
  }
}
```


```json 200 OK (pending)
{
  "success": true,
  "data": {
    "transcription_id": "trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "pending"
  },
  "metadata": {
    "request_id": "req_2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e",
    "timestamp": "2026-03-02T12:00:00Z",
    "processing_time_ms": 320
  }
}
```


```json 200 OK (not enabled)
{
  "success": true,
  "data": {
    "transcription_id": "trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "not_enabled"
  },
  "metadata": {
    "request_id": "req_3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
    "timestamp": "2026-03-02T12:00:00Z",
    "processing_time_ms": 15
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "We couldn't find the resource you're looking for.",
    "system_message": "Transcription not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "transcription_id": "trans_nonexistent"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2026-03-02T12:00:00Z"
  }
}
```

## Related Resources

- [Create Transcription](/docs/api-reference/audio/create-transcription)
- [Get Transcription](/docs/api-reference/audio/get-transcription)
- [List Transcriptions](/docs/api-reference/audio/list-transcriptions)
- [Delete Transcription](/docs/api-reference/audio/delete-transcription)
- [Get Paragraphs](/docs/api-reference/audio/get-paragraphs)
- [Get Sentences](/docs/api-reference/audio/get-sentences)
- [Get Subtitles](/docs/api-reference/audio/get-subtitles)
- [Search Transcript](/docs/api-reference/audio/search-transcript)
- [Upload Audio File](/docs/api-reference/audio/upload-audio)