---
title: "List thumbnails"
method: GET
path: "/v2/sites/{site_id}/thumbnails/"
tags: ["thumbnails"]
---

# List thumbnails

`GET /v2/sites/{site_id}/thumbnails/`

List thumbnails

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Query parameters

- `page` integer
- `page_length` integer
- `q` string
- `sort` string

## Response `200`

Resources successfully retrieved

- ThumbnailResourcesRead
  - `page` integer — Offset for returned resources
  - `page_length` integer — Maximum number of resources to return
  - `total` integer — Number of resources available before pagination
  - `thumbnails` ThumbnailResourceRead[]
    - `schema` string
    - `id` string — Unique identifier for a resource
    - `created` string — Date and time at which the resource was created
    - `last_modified` string — Date and time at which the resource was most recently modified
    - `type` string — Name of the type of resource.
    - `relationships` object — Ancilliary resources associated to the primary resource being read
      - `media` object[], required
        - `id` RelationshipRead
          - `id` string — Unique identifier for a resource
          - `type` string — Resource type
    - `delivery_url` string — Link to retrieve thumbnail The value of this parameter will be `null` until it has been successfully uploaded and `status` is set to `ready`.
    - `file_type` 'jpeg' | 'mp4' — File extension used for this thumbnail
    - `status` 'created' | 'processing' | 'failed' | 'ready' — Readiness state of this thumbnail
    - `thumbnail_type` 'static' | 'video'
    - `source_type` 'custom_upload' | 'default' | 'generic_audio' | 'generic_video' | 'thumbstrip_image' — Source of the thumbnail upload **Possible Values**: - `custom_upload`: User-provided thumbnail - `default`: Default thumbnail automatically pulled from 10 seconds into the video - `generic_audio`: Default thumbnail created for externally hosted media with `media_type` set to `audio` - `generic_video`: Default thumbnail created for externally hosted media with `media_type` set to `video` - `thumbstrip_image`: Thumbnail selected from the thumbstrip images via `video_position` or `thumbstrip_index`
    - `metadata` ThumbnailResourceMetadata

## Other responses

- `400` — Bad Request The request either lacks certain attributes or contains malformed/invalid attributes.
- `404` — Not Found The requested asset could not be found.

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)