---
title: "Get an annotation queue"
method: GET
path: "/v2/annotation-queues/{annotation_queue_id}"
tags: ["Annotation Queues"]
---

# Get an annotation queue

`GET /v2/annotation-queues/{annotation_queue_id}`

Get an annotation queue object by its ID.

This includes the annotation queue's annotation configs, which define the
structure of annotations that can be created in this queue.

This endpoint does not include queue records or annotation progress. To
manage records in a queue, use the Annotation Queue Items endpoints.

<Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Path parameters

- `annotation_queue_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Response `200`

An annotation queue object

- AnnotationQueue
  - `id` string, required — The unique identifier for the annotation queue
  - `name` string, required — The name of the annotation queue
  - `space_id` string, required — The space id the annotation queue belongs to
  - `instructions` string, nullable — The instructions for the annotation queue
  - `annotation_configs` AnnotationConfig[] — The annotation configs associated with this queue
    - union
      - object
        - `id` string, required — The unique identifier for the annotation config
        - `name` string, required — The name of the annotation config
        - `created_at` string, date-time, required — The timestamp for when the annotation config was created
        - `space_id` string, required — The space id the annotation config belongs to
        - `type` 'CONTINUOUS', required — Discriminator value identifying a continuous annotation config.
        - `minimum_score` number, double, required — The minimum score value
        - `maximum_score` number, double, required — The maximum score value
        - `optimization_direction` 'MAXIMIZE' | 'MINIMIZE' | 'NONE' — The direction for optimization. Defaults to `NONE` when omitted. - MAXIMIZE: higher scores are better - MINIMIZE: lower scores are better - NONE: higher or lower scores are neither better nor worse
      - object
        - `id` string, required — The unique identifier for the annotation config
        - `name` string, required — The name of the annotation config
        - `created_at` string, date-time, required — The timestamp for when the annotation config was created
        - `space_id` string, required — The space id the annotation config belongs to
        - `type` 'CATEGORICAL', required — Discriminator value identifying a categorical annotation config.
        - `values` CategoricalAnnotationValue[], required — An array of categorical annotation values
          - `label` string, required — The label value
          - `score` number, double — A score to associate with the label
        - `optimization_direction` 'MAXIMIZE' | 'MINIMIZE' | 'NONE' — The direction for optimization. Defaults to `NONE` when omitted. - MAXIMIZE: higher scores are better - MINIMIZE: lower scores are better - NONE: higher or lower scores are neither better nor worse
      - object
        - `id` string, required — The unique identifier for the annotation config
        - `name` string, required — The name of the annotation config
        - `created_at` string, date-time, required — The timestamp for when the annotation config was created
        - `space_id` string, required — The space id the annotation config belongs to
        - `type` 'FREEFORM', required — Discriminator value identifying a freeform annotation config.
  - `annotators` AnnotatorUser[], required — Users assigned as annotators to this queue
    - `id` string, required — The unique identifier for the user
    - `email` string, email, required — An email address
  - `created_at` string, date-time, required — The timestamp for when the annotation queue was created
  - `updated_at` string, date-time, required — The timestamp for when the annotation queue was last updated

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/versions/1e87d8a4cf69/schema)