Get Queue

GEThttps://api.confident-ai.com/v1/annotation-queues/{queueId}

Retrieves detailed information about a specific annotation queue including comprehensive statistics.

Returns queue metadata, completion metrics (total items, completed items, pending items, completion percentage), and assignment breakdowns showing how many items are assigned to each user and their completion status.

GET/v1/annotation-queues/{queueId}

curl -X GET "https://api.confident-ai.com/v1/annotation-queues/{queueId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "success": true,
  "data": {
    "annotationQueue": {
      "id": "queue-uuid",
      "name": "Trace Review Queue",
      "type": "TRACE",
      "createdAt": "2025-11-12T10:00:00Z",
      "updatedAt": "2025-11-12T11:00:00Z",
      "completedItems": 45,
      "totalItems": 100,
      "pendingItems": 55,
      "completionPercentage": 45,
      "assignedItems": 60,
      "assignmentBreakdown": {
        "user1@example.com": {
          "assigned": 30,
          "completed": 25
        },
        "user2@example.com": {
          "assigned": 30,
          "completed": 20
        }
      }
    }
  }
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

queueIdstringRequired
The ID of the queue to retrieve.

Response

Successfully retrieved annotation queue

successboolean
Indicates if the request was successful.
dataobject
Contains the annotation queue information.
Show 1 propertyHide 1 property
- annotationQueueobject
  The annotation queue details with comprehensive statistics.
  Show 12 propertiesHide 12 properties
  - idstring
    The unique identifier of the annotation queue.
  - namestring
    The name of the annotation queue.
  - typeenum
    The type of items this queue contains.
    Show 5 enum valuesHide 5 enum values
    TRACE
    SPAN
    THREAD
    GOLDEN
    TEST_RUN
  - createdAtstring
    The timestamp when the annotation queue was created.
  - updatedAtstring
    The timestamp when the annotation queue was last updated.
  - testRunIdstring
    The ID of the test run associated with this queue, if applicable.
  - completedItemsinteger
    The number of items in the queue that have been completed.
  - totalItemsinteger
    The total number of items in the queue.
  - pendingItemsinteger
    The number of items in the queue that are still pending completion.
  - completionPercentageinteger
    The percentage of items completed in the queue (0-100).
  - assignedItemsinteger
    The number of items in the queue that have been assigned to users.
  - assignmentBreakdownobject
    A breakdown of assignments by user email, showing how many items are assigned to each user and how many they have completed.

Built byConfident AI