> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Media unavailable

> The job was accepted, but the media can't be fetched: it's private, deleted, age-restricted, region-locked, needs a login, or is still live.

These arrive on the status endpoint as a failed job:

```json theme={null}
{
  "success": true,
  "data": {
    "jobId": "e0b5df98-0867-490a-b321-cd10fdd80130",
    "status": "failed",
    "message": "Source video is private.",
    "code": "VIDEO_PRIVATE",
    "documentationUrl": "https://www.importly.io/docs/errors/media-unavailable"
  }
}
```

| `code` | Meaning | What to do |
| - | - | - |
| `VIDEO_PRIVATE` | The owner made it private | Nothing; ask the owner to make it public or unlisted |
| `VIDEO_UNAVAILABLE` | Deleted, removed, or the account was terminated | Nothing |
| `AGE_RESTRICTED` | The platform requires a signed-in adult | Nothing; age-restricted media isn't supported |
| `AUTH_REQUIRED` | It needs a login, a subscription, or a password | Nothing; only public media is supported |
| `GEO_BLOCKED` | The owner limited it to certain countries. `message` names them when the platform does | Nothing today |
| `LIVE_NOT_SUPPORTED` | The stream is still live | Submit it again after the stream ends |
| `SOURCE_UNAUTHORIZED` | The platform refused the request in a way retrying won't fix | Contact support with the `jobId` |

Nothing is charged for these. Failed imports aren't billed, and failed transcriptions are refunded.

## How to handle it in your app

Show the user the `message`; it's written for people. Don't retry these codes automatically: the result won't change. To check a URL cheaply before a large download, use [`POST /metadata/basic`](/docs/features/metadata) for \$0.01. More on what works: [Supported sites](/docs/features/supported-sites.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.