Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

IAM bearer token issued by the Nebius IAM service. Sent as Authorization: Bearer <iam-token>. Must be combined with the Project header (see IAMProjectHeader).

This is the recommended authentication scheme for new clients.

Project
string
header
required

Nebius project ID associated with the IAM token. Required together with IAMBearerAuth. Identifies the project context the request is scoped to.

Query Parameters

limit
integer
default:100

Maximum number of images to return. Must be between 1 and 1000. Default is 100. Invalid values raise 400 error.

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of images to skip before starting to collect the result set. Default is 0. Invalid values raise 400 error.

Required range: x >= 0
tagged
string

If not 0 only images with tags will be listed. May be avoided or set to 0 to list all images. If no value is provided (like ?tagged, it is considered as 1.

tag
string

A valid image tag prefix to filter images by this prefix. Only images with tags starting with. Implies tagged parameter.

uuid
string<uuid>

Filter images by UUID A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

since
string

Show only results created after the given date/time or interval.

Accepts a Unix timestamp or interval string.

Interval format: 600s/15m/2h/3d/1w means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively).

For example:

  • 2025-01-01T12:00:00+00:00 means January 1st, 2025 at 12:00 UTC
  • 600s means 600 seconds ago
  • 15m means 15 minutes ago

Invalid values raise 400 error.

until
string

Show only results created before the given date/time or interval.

Accepts a Unix timestamp or interval string.

Interval format: 600s/15m/2h/3d/1w means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively).

For example:

  • 2025-01-01T12:00:00+00:00 means January 1st, 2025 at 12:00 UTC
  • 600s means 600 seconds ago
  • 15m means 15 minutes ago

Invalid values raise 400 error.

Response

OK

images
object[]

List of publicly available images