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

# Get media

`GET /media/{id}`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/media/{id}`
- Auth: HTTP bearer

One image or video: `ready` once its file arrived, with its size, dimensions and length, and a link to view it that works for a few hours.

## Path parameters

- `id` string, required: The media's id (`med_`).

## Response `200`

OK

- Media
  - `id` string, required
  - `type` 'image' | 'video' | 'document', required: document: a PDF, which LinkedIn publishes as a document post.
  - `url` string, nullable, required: A link that expires after a few hours: get the media again for a fresh one. Null until the file is uploaded.
  - `alt` string, required
  - `status` 'uploading' | 'ready' | 'failed', required: uploading: waiting for its file. Only ready media can go on a post.
  - `contentType` string, required
  - `size` integer, required: Bytes, once uploaded.
  - `width` integer, nullable, required: Pixels, as shown: read from the file once it is uploaded.
  - `height` integer, nullable, required
  - `duration` number, nullable, required: Seconds, for video.
  - `pages` integer, nullable, required: Pages, for a PDF: read from the file once it is uploaded. Null when they could not be read.
  - `profileId` string, nullable, required: The profile it belongs to: the one it was added for, or else the first post that used it. Null until then, when only whoever added it and people who reach every profile reach it. Keys and people limited to some profiles reach their own media and their profiles'.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

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