# List image metadata

Retrieve metadata for multiple images, including details such as image ID, status, name, and label IDs. This endpoint is useful for retrieving the URLs of images you would like to use in your templates.

Endpoint: GET /v1/REST/images
Version: 1.0.0
Security: basicAuth, bearerAuth

## Query parameters:

  - `ID` (string)
    The ID of the image (UUID).

  - `IDs` (array)
    An array of image IDs.

  - `IsStarred` (boolean)
    Filter by favorite status.

  - `Status` (string)
    Filter by image status. Accepted values: open, locked.
    Enum: "open", "locked"

  - `LabelIDs` (array)
    An array of IDs representing labels associated with the image.

  - `Name` (string)
    The name of the image.

  - `PartialName` (string)
    Search by partial image name.

  - `Limit` (integer)
    The number of results returned per page. Default: 10, maximum: 1000.
    Example: 10

  - `Offset` (integer)
    The index of the first object in the page.

  - `Sort` (string)
    Sort results by a property and select ascending (ASC) or descending (DESC) order.

## Response 200 fields (application/json):

  - `Count` (integer)
    Number of items in this response

  - `Data` (array)

  - `Data.ID` (string)
    The ID of the image (UUID).

  - `Data.Name` (string)
    The name of the image.

  - `Data.Status` (string)
    Indicates whether the image is open or locked. Values: open, locked.

  - `Data.TargetContent` (string)
    Indicates the purpose of the image. Values: image, background, video, social.

  - `Data.ImageSize` (integer)
    The size of the image file in bytes.

  - `Data.LabelIDs` (array)
    An array of IDs representing labels associated with the image.

  - `Data.IsStarred` (boolean)
    Indicates whether the image is marked as a favorite.

  - `Data.ImageUrl` (string)
    The URL where the image is stored.

  - `Data.ThumbnailUrl` (string)
    The URL where the thumbnail is stored.

  - `Data.CreatedAt` (string)
    The date and time when the image was created (RFC3339).

  - `Data.UpdatedAt` (string)
    The date and time when the image was last updated (RFC3339).

  - `Data.ExpiresAt` (string)
    The date and time when the image will expire (RFC3339).

  - `Total` (integer)
    Total number of items available


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields