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

# List annotation queue records

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

List the records in an annotation queue with their data and annotations.

Each record includes:
- The record's data as flat key-value pairs
- Any annotations that have been added to the record
- The users assigned to annotate the record and their completion status
- The record's granularity, applicable when the source type is spans

**Pagination**:
- Response includes `pagination` with `has_more` and `next_cursor`.
- Use cursor-based pagination by passing the returned `next_cursor`
value as the `cursor` query parameter in subsequent requests.

## Path parameters

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

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Returns a list of annotation queue record objects

- ListAnnotationQueueRecordsResponse
  - `records` AnnotationQueueRecord[], required — A list of annotation queue records
    - `id` string, required — The unique identifier for the record
    - `annotation_queue_id` string, required — The annotation queue this record belongs to
    - `source_type` 'SPANS' | 'DATASET', required — Source type of the annotation queue record. - SPANS - The record originates from span data. - DATASET - The record originates from a dataset example.
    - `granularity` 'SPAN' | 'TRACE' — Granularity of an annotation queue record. - SPAN: The record represents a span. - TRACE: The record represents a trace.
    - `data` object, required — Record data as flat key-value pairs containing span or dataset fields. Does not include annotation or evaluation columns.
    - `annotations` Annotation[], required — Annotations on this record.
      - `name` string, required — The name of the annotation
      - `score` number, double — Numeric score for the annotation
      - `label` string — Categorical label for the annotation
      - `text` string — Free-form text note for the annotation
      - `updated_at` string, date-time — Timestamp when the annotation was last updated
      - `annotator` AnnotatorUser — A user assigned as an annotator, identified by ID and email.
        - `id` string, required — The unique identifier for the user
        - `email` string, email, required — An email address
    - `trace_annotations` Annotation[], required — Trace annotations on this record.
      - `name` string, required — The name of the annotation
      - `score` number, double — Numeric score for the annotation
      - `label` string — Categorical label for the annotation
      - `text` string — Free-form text note for the annotation
      - `updated_at` string, date-time — Timestamp when the annotation was last updated
      - `annotator` AnnotatorUser — A user assigned as an annotator, identified by ID and email.
        - `id` string, required — The unique identifier for the user
        - `email` string, email, required — An email address
    - `evaluations` Evaluation[], required — Evaluation results on this record
      - `name` string, required — The name of the evaluation
      - `score` number, double — Numeric score for the evaluation
      - `label` string — Categorical label for the evaluation
      - `explanation` string — Explanation for the evaluation result
    - `assigned_users` AnnotationQueueAssignedUser[], required — Users assigned to this record
      - `user` AnnotatorUser, required — A user assigned as an annotator, identified by ID and email.
        - `id` string, required — The unique identifier for the user
        - `email` string, email, required — An email address
      - `completion_status` 'PENDING' | 'COMPLETED', required — Completion status for a user's annotation assignment on a record. - PENDING - The user has not yet submitted annotations. - COMPLETED - The user has submitted annotations.
  - `pagination` PaginationMetadata, required — Cursor-based pagination metadata. Use `next_cursor` in the subsequent request's `cursor` query parameter.
    - `next_cursor` string — Opaque cursor for fetching the next page. Treat as an unreadable token. Present when `has_more` is true; omitted when `has_more` is false.
    - `has_more` boolean, required — True if another page of results is available.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.dev/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/revisions/6521535a37bb/schema)