---
title: "GET /tracer/eval-task/get_usage/"
method: GET
path: "/tracer/eval-task/get_usage/"
tags: ["tracer"]
---

# GET /tracer/eval-task/get_usage/

`GET /tracer/eval-task/get_usage/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/eval-task/get_usage/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Query parameters

- `eval_task_id` string, uuid, required
- `period` '30m' | '1h' | '6h' | '1d' | '7d' | '30d' | '90d' | '180d' | '365d'
- `eval_id` string, uuid
- `page` integer
- `page_size` integer
- `limit` integer
- `eval_aggregation` boolean
- `span_aggregation` boolean
- `include_summary` boolean
- `start_date` string, date-time
- `end_date` string, date-time

## Response `200`

OK

- EvalTaskUsageResponse
  - `status` boolean
  - `result` EvalTaskUsageResult, required
    - `eval_task_id` string, uuid, required
    - `stats` EvalTaskUsageStats
      - `total_runs` integer, required
      - `runs_period` integer, required
      - `success_count` integer, required: Deprecated compatibility field. Usage counts only successful runs, so this always equals runs_period.
      - `error_count` integer, required: Deprecated compatibility field. Usage counts only successful runs, so this is always 0; failed runs stay in the task logs.
      - `pass_rate` number, required: Deprecated compatibility field. Usage counts only successful runs, so this is 100 when runs_period is above 0, otherwise 0.
      - `total_runs_is_lower_bound` boolean
      - `runs_period_is_lower_bound` boolean
    - `evals` EvalTaskUsageEval[]
      - `id` string, uuid, required
      - `name` string, required
      - `output_type` string, required
      - `template_id` string, uuid, nullable, required
      - `model` string, nullable, required
    - `chart` EvalTaskUsageChartPoint[]
      - `timestamp` string, date-time, required
      - `calls` integer, required
      - `pass_count` integer, required
      - `fail_count` integer, required
      - `avg_score` number, nullable, required
      - `avg_latency_ms` number, required
    - `logs` EvalTaskUsageLogs
      - `count` integer, required
      - `next` string, nullable, required
      - `previous` string, nullable, required
      - `results` EvalTaskUsageLog[], required
        - `id` string, uuid, required
        - `input` string, required
        - `result` string, required
        - `score` number, nullable, required
        - `reason` string, required
        - `status` 'success' | 'error', required
        - `source` string, required
        - `warnings` object, required: Any valid JSON value.
        - `created_at` string, date-time, required
        - `span_id` string, nullable, required
        - `trace_id` string, nullable, required
        - `session_id` string, nullable, required
        - `eval_id` string, uuid, nullable, required
        - `eval_name` string, nullable, required
        - `model` string, nullable, required
        - `detail` EvalTaskUsageLogDetail, required
          - `detail_complete` boolean, required
          - `omitted_fields` string[], required
          - `eval_name` string, nullable, required
          - `model` string, nullable, required
          - `warnings` object, required: Any valid JSON value.
          - `output_type` string, nullable, required
          - `target_type` string, nullable, required
          - `span_name` string, nullable, required
          - `span_id` string, nullable, required
          - `trace_id` string, nullable, required
          - `session_id` string, nullable, required
          - `session_name` string, nullable, required
          - `output_bool` boolean, nullable, required
          - `output_float` number, nullable, required
          - `output_str` string, nullable, required
          - `results_explanation` object, nullable, required: Any valid JSON value.
          - `error_message` string, nullable, required
          - `input_variables` object, required: Any valid JSON value.
      - `total_pages` integer, required
      - `current_page` integer, required
      - `has_more` boolean
      - `count_is_lower_bound` boolean
      - `page_limit_reached` boolean
    - `period_requested` string
    - `period_used` string
    - `eval_aggregation` object: Any valid JSON value.
    - `span_aggregation` object: Any valid JSON value.
    - `aggregation_metadata` EvalTaskUsageAggregationMetadata
      - `query_complete` boolean, required
      - `sampled` boolean, required
      - `error` 'sample_limit', nullable, required
      - `provenance` string, required
      - `row_limit` integer, required
      - `rows_scanned` integer, required
      - `rows_matched` integer, required
    - `query_complete` boolean
    - `query_status` 'complete' | 'sampled'
    - `query_sampled` boolean
    - `error` 'sample_limit'
    - `provenance` string

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)