Sign in
Projects

List projects

Retrieve a list of projects. Counter fields in each result follow one of two scopes:

  • Per-user progress — computed for the authenticated user and their project role (for example reviewed_number, review_total_tasks, queue_done, queue_total, queue_left). These power project-card progress in the UI and differ across users. Note: queue_left counts manual review assignments only; when it is 0, the card uses review_total_tasks / reviewed_number for auto-review progress.
  • Project-wide totals — the same for every caller (for example task_number, finished_task_number).

For organization-level reviewed-task totals (all reviewers combined), use GET /api/analytics/kpis/tasks_reviewed?projects={id}&tz=UTC rather than reviewed_number. See Analytics KPI tasks_reviewed, tasks_pending_review, annotated_tasks, and total_tasks for other project-wide metrics.

get/api/projects/

Query parameters

archivedboolean

Filter by projects that belong to archived workspaces

filterstring

Filter projects by pinned status. Use 'pinned_only' to return only pinned projects, 'exclude_pinned' to return only non-pinned projects, or 'all' to return all projects.

idsstring

Multiple values may be separated by commas. (comma-separated values)

includestring

Comma-separated list of count fields to include in the response to optimize performance. Available fields: task_number, finished_task_number, total_predictions_number, total_annotations_number, num_tasks_with_annotations, useful_annotation_number, ground_truth_number, skipped_annotations_number. If not specified, all count fields are included.

members_limitinteger

Maximum number of members to return

orderingstring

Which field to use when ordering the results.

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

searchstring

Search term for project title and description

source_interface_idnumber

Filter lse_project__source_interface_id by exact match

statestring

Filter current_state by exact match

titlestring

Filter title by contains (case-insensitive)

workspacesnumber

Filter workspaces by exact match

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}

Changes