> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # List publicly available images > Returns a list of all publicly available container images. ## OpenAPI ````yaml https://eu-north.nebius.computer/static/api.yaml get /images openapi: 3.0.0 info: title: Contree API description: > Contree is a container management system combining virtual machine isolation with container operational efficiency. Designed for security-sensitive workloads requiring hardware-enforced boundaries while maintaining container workflow compatibility. version: 1.0.0 servers: - url: '{baseUrl}/v1' description: | Nebius IAM-fronted endpoint (use `IAMBearerAuth` + `IAMProjectHeader`). Override `baseUrl` to point at a different deployment. variables: baseUrl: default: https://api.tokenfactory.nebius.com/sandboxes description: | Base URL of the contree service. Defaults to the public Nebius IAM-fronted endpoint; set to your self-hosted contree origin (e.g. `https://contree.example.com`) when running elsewhere. security: - IAMBearerAuth: [] IAMProjectHeader: [] tags: - name: images description: Operations related to container images - name: files description: Operations related to file uploads - name: instances description: Operations related to container instances - name: inspect description: Operations related to inspecting container images - name: operations description: Operations related to long-running operations - name: auth description: Authentication and token introspection paths: /images: get: tags: - images summary: List publicly available images description: | Returns a list of all publicly available container images. operationId: listImages parameters: - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 1000 default: 100 description: | Maximum number of images to return. Must be between 1 and 1000. Default is 100. Invalid values raise 400 error. - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 description: | Number of images to skip before starting to collect the result set. Default is 0. Invalid values raise 400 error. - name: tagged in: query required: false schema: type: string description: > 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`. example: '1' - name: tag in: query required: false schema: type: string description: > A valid image tag prefix to filter images by this prefix. Only images with tags starting with. Implies `tagged` parameter. example: ubuntu - name: uuid in: query required: false schema: $ref: '#/components/schemas/UUIDSchema' description: Filter images by UUID - $ref: '#/components/parameters/SinceParameter' - $ref: '#/components/parameters/UntilParameter' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ImageListResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' components: schemas: UUIDSchema: type: string format: uuid description: A UUID string example: 12345678-9abc-baba-deda-0123456789ab ImageListResponse: type: object properties: images: type: array items: $ref: '#/components/schemas/Image' description: List of publicly available images Image: type: object properties: uuid: $ref: '#/components/schemas/UUIDSchema' tag: type: string nullable: true description: Tag to identify the image example: busybox:latest created_at: type: string description: ISO 8601 formatted timestamp of when the image was created example: '2024-01-01T12:00:00+00:00' operation_uuid: nullable: true allOf: - $ref: '#/components/schemas/UUIDSchema' description: > UUID of the operation that created this image. Returns `null` when the image belongs to a different namespace (e.g. public images) or when the image was not created by an operation (e.g. shared images). Error: type: object required: - error properties: error: oneOf: - type: string - type: object - type: array items: type: object description: Error message or structured validation errors example: Some error occurred, this is an example of error message status: type: integer description: HTTP status code example: 500 traceback: type: array items: type: string parameters: SinceParameter: name: since in: query required: false schema: type: string example: 1w description: > **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. UntilParameter: name: until in: query required: false description: > **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. schema: type: string example: 1h responses: BadRequest: description: Bad Request - Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: | Unauthorized - Invalid or missing authentication credentials. Either the `Authorization` bearer token is missing or invalid, or the `Project` header is missing. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Forbidden - Token does not have sufficient permissions content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: IAMBearerAuth: type: http scheme: bearer bearerFormat: IAM description: | IAM bearer token issued by the Nebius IAM service. Sent as `Authorization: Bearer `. Must be combined with the `Project` header (see `IAMProjectHeader`). This is the recommended authentication scheme for new clients. IAMProjectHeader: type: apiKey in: header name: Project description: | Nebius project ID associated with the IAM token. Required together with `IAMBearerAuth`. Identifies the project context the request is scoped to. ````