List Queue Items
List items in an annotation queue with optional filtering and pagination.
List Queue Items
Retrieve a paginated list of items in an annotation queue, optionally filtered by status, source type, or assignee.
GET
https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/
Bearer
Click "Try It" to send a request
Authentication
| Header | Description |
|---|---|
X-Api-Key | Your API key |
X-Secret-Key | Your secret key |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
queue_id | UUID | Yes | The annotation queue ID |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: pending, in_progress, completed, skipped |
source_type | string | No | Filter by source type (e.g. trace) |
assigned_to | UUID | No | Filter by assigned user |
page | integer | No | Page number |
page_size | integer | No | Results per page |
Response
Paginated response with count, next, previous, and results array of queue item objects.
Code Examples
import requests
queue_id = "your-queue-uuid"
resp = requests.get(
f"https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/",
headers={"X-Api-Key": "YOUR_KEY", "X-Secret-Key": "YOUR_SECRET"},
params={"status": "pending", "page_size": 20}
)
print(resp.json())import axios from 'axios';
const queueId = 'your-queue-uuid';
const resp = await axios.get(
`https://api.futureagi.com/model-hub/annotation-queues/${queueId}/items/`,
{
headers: { 'X-Api-Key': 'YOUR_KEY', 'X-Secret-Key': 'YOUR_SECRET' },
params: { status: 'pending', pageSize: 20 }
}
);
console.log(resp.data);curl "https://api.futureagi.com/model-hub/annotation-queues/your-queue-uuid/items/?status=pending&page_size=20" \
-H "X-Api-Key: YOUR_KEY" \
-H "X-Secret-Key: YOUR_SECRET" Was this page helpful?