List Annotation Queues | Confident AI Docs

import requests
url = "https://api.confident-ai.com/v1/annotation-queues"
headers = {"CONFIDENT_API_KEY": "<PROJECT-API-KEY>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "success": true,
  "data": {
    "annotationQueues": [
      {
        "id": "queue-uuid-1",
        "name": "Trace Review Queue",
        "type": "TRACE",
        "createdAt": "2025-11-12T10:00:00Z",
        "updatedAt": "2025-11-12T11:00:00Z",
        "completedItems": 45,
        "totalItems": 100,
        "completionPercentage": 45
      },
      {
        "id": "queue-uuid-2",
        "name": "Span Quality Check",
        "type": "SPAN",
        "createdAt": "2025-11-11T09:00:00Z",
        "updatedAt": "2025-11-12T10:00:00Z",
        "completedItems": 20,
        "totalItems": 50,
        "completionPercentage": 40
      }
    ],
    "total": 2,
    "limit": 1,
    "offset": 1
  }
}

Retrieves all annotation queues in your project with statistics and pagination support. Each queue includes completion metrics, item counts, and assignment breakdowns.

Filter results by queue type (TRACE, SPAN, THREAD, GOLDEN, TEST_RUN) or search by name. Queues are returned in descending order by creation date.

Query parameters

pageintegerOptional>=1

This specifies the page number of the annotation queues to return. Defaulted to 1.

pageSizeintegerOptional>=1

This specifies the maximum number of annotation queues per page. Defaulted to 25.

startstringOptionalformat: "date-time"

This filters for annotation queues created after the specified start datetime. Defaulted to 30 days ago.

endstringOptionalformat: "date-time"

This filters for annotation queues created before the specified end datetime. Defaulted to the current time.

sortByenumOptional

This determines the field to sort by. Defaulted to createdAt.

Allowed values:

ascendingbooleanOptional

This determines if the field specified in sortBy should be in ascending order. Defaults to false.

typeenumOptional

Filter by queue type

Allowed values:

searchTermstringOptional

Search queues by name

Response

Successfully retrieved list of annotation queues

successboolean

Indicates if the request was successful.

dataobject

Headers

Query parameters

Response