---
title: "Get a media file"
method: GET
path: "/media/{media_id}/"
tags: ["Media"]
---

# Get a media file

`GET /media/{media_id}/`

## Request

- Base URL: `https://wbiztool.com/api/v1`
- URL: `https://wbiztool.com/api/v1/media/{media_id}/`
- Auth: none required

Details and download URL of one Media directory file by ID; credentials in the query string. Always HTTP 200 (check `status`), except an HTML 404 for a non-numeric ID.

## Query parameters

- `client_id` integer, required
- `api_key` string, required

## Response `200`

The file (`status: 1`) or an error (`status: 0`). Errors also come back with HTTP 200 and `status: 0`: `client_id is required`, `api_key is required`, `client_id must be a valid integer`, `Invalid API key`, `Invalid client_id for this API key`, `Media file not found`, `Error retrieving media file: …`.

- union
  - MediaUploaded
    - `status` 1, required
    - `message` string, required
    - `data` MediaFile, required
      - `id` integer: ID of the media file.
      - `file_name` string: Name the file is stored under (generated by WbizTool).
      - `original_file_name` string: The name of the uploaded file.
      - `file_url` string, uri: Public download URL; use it as `img_url` or `file_url` when sending. Store it as it is (CDN or S3 host).
      - `file_type` 'image' | 'file'
      - `file_size` integer: Size in bytes.
      - `file_size_display` string
      - `mime_type` string
      - `is_image` boolean
      - `file_extension` string: Lower-case extension without the dot.
      - `created_at` string, date-time
      - `uploaded_by` string, nullable: Login username of the team member who uploaded the file. Not returned by the upload endpoint.
      - `modified_at` string, date-time: Only returned by the get-media endpoint.
  - MediaError
    - `status` 0, required
    - `message` string, required

---

[API](https://skmtc.dev/wbiztool/apis/wbiztool-api.md) · [All operations](https://skmtc.dev/wbiztool/apis/wbiztool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wbiztool/apis/wbiztool-api/revisions/bc7380bb5684?raw)