> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/api-reference/media/get-media.md).

# Get Media

Use this endpoint to retrieve a previously uploaded media file using its unique media ID.

### Endpoint

```
GET /media/{media_id}
```

Full URL:

```
https://api.taqnyat.sa/wa/v2/media/{media_id}
```

Replace `{media_id}` with the ID returned when the media was uploaded.

### Authentication

Include your API token in the `Authorization` header:

```
Authorization: <YOUR_TOKEN>
```

### Path Parameters

| Parameter  | Type   | Required | Description                                   |
| ---------- | ------ | -------- | --------------------------------------------- |
| `media_id` | String | Yes      | Unique identifier of the uploaded media file. |

### Example Request

```bash
curl --location 'https://api.taqnyat.sa/wa/v2/media/<MEDIA_ID>' \
--header 'Content-Type: application/json' \
--header 'Authorization: <YOUR_TOKEN>'
```

Example:

```bash
curl --location 'https://api.taqnyat.sa/wa/v2/media/178XXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Authorization: <YOUR_TOKEN>'
```

### Request Body

This endpoint does not require a request body.

### Response

The response returns information or access data related to the requested media resource.

Use the exact production response returned by Postman when documenting the response schema.

> Add the actual response example here once available instead of using an assumed structure.

### Example Flow

```
Upload Media     
    ↓
media_id returned     
    ↓
GET /media/{media_id}     
    ↓
Media resource
```

### Notes

* `media_id` is passed directly in the URL path.
* Use the exact media ID returned by the Upload Media endpoint.
* No JSON request body is required.
* The endpoint should only be used for media associated with the authenticated account.