Skip to main content
GET
/
api
/
v1
/
usage
/
tasks
/
{task_id}
Get task usage by ID
curl --request GET \
  --url https://neo.api.projectdiscovery.io/api/v1/usage/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "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
}

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

Path Parameters

task_id
string
required

The unique task identifier

Response

Task usage data

agent_triggers
integer
required

Total agent triggers

created_at
string<date-time>
required

When the task was created

model
string
required

LLM model used

status
enum<string>
required

Execution status

Available options:
completed,
error,
failed,
aborted
step_count
integer
required

Number of steps executed

task_id
string
required

Task ID

tool_calls
integer
required

Total tool calls made

agent_breakdown
object

Agent trigger counts by agent name

avg_step_latency_ms
integer | null

Average step latency in milliseconds

email
string

Email of the user who created the task (only visible to team admins)

error_message
string | null

Error message if status is error

is_byok
boolean

Whether the task used a Bring Your Own Key (BYOK) provider

llm_cost
number<float> | null

LLM cost for BYOK usage. Returns the same base amount previously exposed as neo_credits.

llm_time_ms
integer | null

Total LLM inference time in milliseconds

neo_cost
number<float> | null

Neo platform cost for BYOK usage after applying neo_cost_rate

neo_credits
number<float> | null

Neo credits used (1 credit = $10 USD equivalent)

stream_count
integer

Number of streams aggregated (1 if single stream)

stream_id
string<uuid>

Stream ID (only present for individual streams, omitted for grouped tasks)

task_title
string | null

Task title when available

tool_breakdown
object

Tool call breakdown with calls and duration

tool_call_history
object[] | null

Detailed tool call history

tool_time_ms
integer | null

Total tool execution time in milliseconds

total_execution_ms
integer | null

Total execution time in milliseconds