Skip to main content
GET
/
api
/
v1
/
usage
/
tasks
List all task usages
curl --request GET \
  --url https://neo.api.projectdiscovery.io/api/v1/usage/tasks \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "agent_triggers": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "model": "<string>",
      "status": "completed",
      "step_count": 123,
      "task_id": "<string>",
      "tool_calls": 123,
      "agent_breakdown": {},
      "avg_step_latency_ms": 123,
      "email": "<string>",
      "error_message": "<string>",
      "is_byok": true,
      "llm_cost": 123,
      "llm_time_ms": 123,
      "neo_cost": 123,
      "neo_credits": 123,
      "stream_count": 123,
      "stream_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "task_title": "<string>",
      "tool_breakdown": {},
      "tool_call_history": [
        {
          "duration_ms": 123,
          "index": 123,
          "timestamp": 123,
          "tool_name": "<string>"
        }
      ],
      "tool_time_ms": 123,
      "total_execution_ms": 123
    }
  ],
  "has_more": true,
  "total": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

task_id
string

Filter by specific task ID

status
enum<string>

Filter by task status

Available options:
completed,
error,
failed,
aborted
model
string

Filter by model

from
string<date-time>

Filter from datetime (ISO 8601)

to
string<date-time>

Filter to datetime (ISO 8601)

limit
integer
default:50

Number of results (1-200, default 50)

Required range: 1 <= x <= 200
offset
integer
default:0

Pagination offset (default 0)

Required range: x >= 0

Filter tasks by task ID or email (case-insensitive partial match)

email
string

Filter by team member email (exact match, only for team admins)

is_byok
boolean

Filter by BYOK status (true = only BYOK tasks, false = only non-BYOK tasks)

Response

List of tasks with aggregated usage

data
object[]
required
has_more
boolean
required

Whether there are more records

total
integer
required

Total number of records