# List labels

Retrieve a list of your labels. Labels are used to categorize your images or templates by assigning tags to them.

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

## Query parameters:

  - `Name` (string)
    Search by the name of the label. Only returns exact match.

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

  - `UsedFor` (string)
    Filter labels by type. Possible values: image, resource. Cannot retrieve both in one request. Default: resource.
    Enum: "image", "resource"

  - `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. Available: Name. Default: ID ASC.

## Response 200 fields (application/json):

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

  - `Data` (array)

  - `Data.ID` (integer)
    The ID of the label.

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

  - `Data.Color` (string)
    The hexadecimal color of the label (e.g.

  - `Data.UsedFor` (string)
    Indicates if the label is used for a template or an image. Values: resource, image.

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


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields