For the complete documentation index, see llms.txt. This page is also available as Markdown.

Analytics

Analytics and performance metrics

Get Project Performance Metrics

post
/performance/{projectId}

Retrieves performance statistics and metrics for a project

Authorizations
apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters
projectIdstringRequired

Project ID

Body
intervalstring · date-time[] · min: 2 · max: 2Optional

Date-time range as [startISO, endISO].

batchesstring[]Optional
Responses
200

Performance metrics retrieved successfully

application/json
statusstringOptionalExample: success
post/performance/{projectId}
POST /v2/performance/{projectId} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "interval": [
    "2026-01-01T00:00:00.000Z"
  ],
  "batches": [
    "text"
  ]
}
200

Performance metrics retrieved successfully

{
  "status": "success",
  "data": {
    "performance": [
      {
        "_id": "text",
        "email": "text",
        "completedLabels": 1,
        "totalLabelingDuration": 1,
        "avgLabelingDuration": 1,
        "avgBenchmark": 1,
        "totalLabelingIdleDuration": 1,
        "totalLabelingBlurDuration": 1,
        "completedReviews": 1,
        "totalReviewDuration": 1,
        "avgReviewDuration": 1,
        "totalReviewIdleDuration": 1,
        "totalReviewBlurDuration": 1
      }
    ]
  }
}

Retrieve Project Overview

get
/{projectId}/overview/{type}

Retrieves various analytics and overview metrics for a project.

Available types:

  • AssetSize: Number of assets in the project

  • LabelStageGroups: Task count by stage

  • AverageDurationPerStage: Average time spent per stage

  • TimePerTask: Time distribution across tasks

  • AnnotationStatus: Annotation completion status

  • AnswerDistribution: Distribution of answers

  • ConsensusRanges: Consensus score ranges

Authorizations
apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters
projectIdstringRequired

Project ID

typestring · enumRequired

Overview type

Possible values:
Query parameters
filterstringOptional

JSON object narrowing the tasks the metric is computed over, for example {"batches":"507f1f77bcf86cd799439011"} or {"updatedAt":{"$gt":"2026-01-01T00:00:00.000Z"}}. Only full ISO timestamps are read as dates, and a $regex value is matched as a case-insensitive substring rather than as a regular expression. Invalid JSON is ignored silently and the unfiltered result is returned. AssetSize takes no filter.

schemaIdstringOptional

ConsensusRanges only. Scores a single consensus schema instead of averaging over the task.

Responses
200

Overview retrieved successfully. An unrecognised type also answers 200, with an empty data object.

application/json
statusstringOptionalExample: success
get/{projectId}/overview/{type}
GET /v2/{projectId}/overview/{type} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*
{
  "status": "success",
  "data": {
    "overview": {}
  }
}

Last updated