# Get Media

[View original](https://ittybit.com/api/media/get)


`GET /media/{id}`

Retrieves the media object for a media with the given ID.

### Parameters

```json
[
  {
    "in": "path",
    "name": "id",
    "required": true,
    "schema": {
      "type": "string",
      "example": "med_abcdefgh1234"
    }
  }
]
```

### Responses

#### 200 - Success

**Example:**

```json
{
  "meta": {
    "request_id": "req_abcdefghij1234567890",
    "org_id": "org_abcdefgh1234",
    "project_id": "prj_abcdefgh1234",
    "version": "2025-01-01",
    "type": "object"
  },
  "data": {
    "id": "med_abcdefgh1234",
    "object": "media",
    "kind": "video",
    "title": "My Video Example",
    "alt": "An example video used to demonstrate the ittybit API",
    "width": 1920,
    "height": 1080,
    "duration": 123.45,
    "files": [
      {
        "id": "file_abcdefgh1234",
        "object": "source",
        "kind": "video",
        "format": "mp4",
        "type": "video/mp4; codecs=\"avc1.6431, mp4a.40.2\"",
        "width": 1920,
        "height": 1080,
        "duration": 123.45,
        "filesize": 12345678,
        "folder": "example",
        "filename": "video.mp4",
        "url": "https://you.ittybit.net/example/video.mp4",
        "ref": "original",
        "created": "2025-01-01T01:23:45Z",
        "updated": "2025-01-01T01:23:45Z"
      },
      {
        "id": "file_abcdefgh5678",
        "object": "source",
        "kind": "image",
        "format": "png",
        "type": "image/png",
        "width": 640,
        "height": 360,
        "filesize": 123456,
        "folder": "example",
        "filename": "image.png",
        "url": "https://you.ittybit.net/example/image.png",
        "ref": "thumbnail",
        "created": "2025-01-01T01:23:46Z",
        "updated": "2025-01-01T01:23:46Z"
      }
    ],
    "urls": {
      "original": "https://you.ittybit.net/example/video.mp4",
      "thumbnail": "https://you.ittybit.net/example/image.png"
    },
    "background": "#2OBO75",
    "metadata": {
      "customKey": "your custom value"
    },
    "created": "2025-01-01T01:23:45Z",
    "updated": "2025-01-01T01:23:46Z"
  },
  "error": null,
  "links": {
    "self": "https://api.ittybit.com/media/med_abcdefgh1234",
    "parent": "https://api.ittybit.com/media"
  }
}
```