---
title: "List the site's uploaded images"
method: GET
path: "/v1/sites/{site_id}/images"
tags: ["Images"]
---

# List the site's uploaded images

`GET /v1/sites/{site_id}/images`

## Request

- Base URL: `https://api.getsitecontrol.com`
- URL: `https://api.getsitecontrol.com/v1/sites/{site_id}/images`
- Auth: HTTP bearer

The site's image library: the files the widget and email editors show in their
Upload tab, with the public `url` of each. Call it to use an image the user
uploaded, e.g. "the photo I just uploaded": with `order=newest` the latest
upload comes first.

A page holds up to `limit` images; while `next_cursor` is set, pass it as
`cursor` for the next page.

## Path parameters

- `site_id` integer, required

## Query parameters

- `cursor` string: `next_cursor` of the previous page, sent with the same `order`; omit for the first
- `limit` integer: Items per page
- `fields` string: Comma-separated fields to keep in each item, for example `id,name`; each item then carries only those fields and `id`. Omit for every field
- `order` 'oldest' | 'newest': Order of a list. oldest: the oldest item first; newest: the newest item first, for the latest items without paging through the history.

## Response `200`

Successful Response

- ImagePage: One page of a list; `next_cursor` is null on the last page.
  - `items` Image[], required
    - `id` integer, required
    - `name` string, nullable: File name with its extension, as it was uploaded; `image.<ext>` for a file sent to an upload link
    - `url` string, required: Public address of the image. The widget and email image tools take this URL, e.g. as the hero image or an image block's source
    - `width` integer, nullable: Pixels; null when the file's header does not say, as for SVG
    - `height` integer, nullable: Pixels; null when the file's header does not say, as for SVG
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable

## Other responses

- `400`: Unsupported GSC-Version
- `401`: Missing or invalid API key or access token
- `403`: Access denied
- `404`: Not found
- `422`: Validation failed
- `429`: Rate limited
- `503`: Temporarily unavailable; retry later

---

[API](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api.md) - [All operations](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/revisions/084fcad80e75?raw)