> ## 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. # List all task usages > List usage data for all tasks with aggregated metrics. Each task may contain multiple streams (executions), and this endpoint returns the combined totals for each task including cost, tool calls, and execution times. Access control: - Solo users (not in a team): Can view their own tasks only - Team admins: Can view all team members' tasks (with email field and optional email filter) - Team members/viewers: No access (returns 403) ## OpenAPI ````yaml /openapi/neo.public.openapi.json get /api/v1/usage/tasks openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Development url: https://neo.api.dev.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Connect personal AI provider accounts and select them as a model source name: AI Connections - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: User-authored tools and toolkit management name: Dynamic Tools - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events - description: User and team API activity metadata name: Audit Logs - description: Vulnerability triage for HackerOne, GitHub, and Security Inbox name: Triage paths: /api/v1/usage/tasks: get: tags: - Usage summary: List all task usages description: > List usage data for all tasks with aggregated metrics. Each task may contain multiple streams (executions), and this endpoint returns the combined totals for each task including cost, tool calls, and execution times. Access control: - Solo users (not in a team): Can view their own tasks only - Team admins: Can view all team members' tasks (with email field and optional email filter) - Team members/viewers: No access (returns 403) operationId: get-v1-usage-tasks parameters: - description: Filter by specific task ID in: query name: task_id required: false schema: type: string - description: Filter by task status in: query name: status required: false schema: enum: - completed - error - failed - aborted - blocked type: string - description: Filter by model in: query name: model required: false schema: type: string - description: Filter from datetime (ISO 8601) in: query name: from required: false schema: format: date-time type: string - description: Filter to datetime (ISO 8601) in: query name: to required: false schema: format: date-time type: string - description: Number of results (1-200, default 50) in: query name: limit required: false schema: default: 50 maximum: 200 minimum: 1 type: integer - description: Pagination offset (default 0) in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: Filter tasks by task ID or email (case-insensitive partial match) in: query name: search required: false schema: type: string - description: Filter by team member email (exact match, only for team admins) in: query name: email required: false schema: type: string - deprecated: true description: Deprecated; use usage_source. Filters direct BYOK tasks only. in: query name: is_byok required: false schema: type: boolean - description: Filter tasks by billing and credential source in: query name: usage_source required: false schema: enum: - neo - byok - ai_connections type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaskUsageListResponse' description: List of tasks with aggregated usage '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden - team members/viewers cannot access usage data '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: TaskUsageListResponse: properties: data: items: $ref: '#/components/schemas/TaskUsage' type: array has_more: description: Whether there are more records type: boolean total: description: Total number of records type: integer required: - data - total - has_more type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. `access_restricted` (HTTP 403) denies hosted Neo access under the access policy. On team invitations, param=email identifies a restricted recipient rather than the caller; show the error without redirecting the caller. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; Free/usage codes include `free_grant_challenge_required`, `free_usage_exhausted`, `free_task_budget_exhausted`, `model_not_available_on_free`, `sandbox_not_available_on_free` (cloud sandbox surfaces are not available on the Free plan; task files remain available from the task), `free_cannot_continue_managed_task` (a task that ran on the standard cloud sandbox cannot be continued on the Free plan; start a new task), `free_origin_not_supported` (integration-originated tasks are not available on the Free plan), `weekly_usage_limit_reached`, `billing_period_usage_limit_reached`, `topup_required`, `subscription_required`, and `isolated_workspace_purged`. Otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string param: description: >- Field rejected by the policy; email for a restricted invite recipient. type: string turnstile_site_key: description: | Public Cloudflare Turnstile site key returned only with `free_grant_challenge_required`, so the client can complete the invisible verification before retrying the request. type: string required: - error type: object TaskUsage: properties: agent_breakdown: additionalProperties: type: integer description: Agent trigger counts by agent name nullable: true type: object agent_triggers: description: Total agent triggers type: integer created_at: description: When the task was created format: date-time type: string email: description: Email of the user who created the task (only visible to team admins) type: string error_message: description: Error message if status is error nullable: true type: string input_tokens: description: >- Input tokens reported by the upstream provider. Omitted when unavailable. type: integer is_byok: deprecated: true description: Deprecated compatibility field. True only when usage_source is byok. type: boolean leaf_tool_sum_ms: description: >- Sum of leaf tool execution time, excluding trigger_* (nested subagent) wait. nullable: true type: integer llm_active_wall_ms: description: >- Wall-clock union of overlapping LLM call intervals. Never exceeds total_execution_ms. nullable: true type: integer llm_cost: description: >- Provider LLM cost in USD. Present for direct BYOK tasks; omitted for platform-billed tasks and AI connection tasks. Connected subscription providers do not currently report their per-request charge. Preserves up to six decimal places when present. format: float type: number llm_latency_sum_ms: description: >- Sum of pure per-step provider round-trip latencies, excluding tool execution. Additive: overlapping/nested calls do not cancel out, so this can exceed total_execution_ms. nullable: true type: integer model: description: LLM model used type: string neo_cost: description: >- Neo platform cost in USD for direct BYOK usage, llm_cost multiplied by the account's neo_cost_rate. Omitted for platform-billed and AI connection tasks. Preserves up to six decimal places when present. format: float type: number neo_credits: description: >- Neo credits charged for platform-billed usage. Present only when usage_source is neo; omitted for BYOK and AI connection tasks. Task and stream usage preserves up to six decimal places so sub-cent usage remains visible. format: float type: number output_tokens: description: >- Output tokens reported by the upstream provider. Omitted when unavailable. type: integer provider_latency_avg_ms: description: Average pure provider latency per LLM step. nullable: true type: integer provider_latency_p50_ms: description: Median (p50) pure provider latency across this task's LLM steps. nullable: true type: integer provider_latency_p95_ms: description: p95 pure provider latency across this task's LLM steps. nullable: true type: integer reasoning_tokens: description: >- Reasoning tokens reported by the upstream provider. Omitted when unavailable. type: integer status: description: Execution status enum: - completed - error - failed - aborted - blocked type: string step_count: description: Number of steps executed type: integer stream_count: description: Number of streams aggregated (1 if single stream) type: integer stream_id: description: >- Stream ID (only present for individual streams, omitted for grouped tasks) format: uuid type: string task_id: description: Task ID type: string task_title: description: Task title when available nullable: true type: string tool_active_wall_ms: description: Wall-clock union of overlapping leaf-tool call intervals. nullable: true type: integer tool_breakdown: additionalProperties: $ref: '#/components/schemas/ToolBreakdownEntry' description: Tool call breakdown with calls and duration nullable: true type: object tool_call_history: description: Detailed tool call history items: $ref: '#/components/schemas/ToolCallHistoryEntry' nullable: true type: array tool_calls: description: Total tool calls made type: integer total_execution_ms: description: Total execution time (wall clock) in milliseconds nullable: true type: integer total_tokens: description: Total reported input and output tokens. Omitted when unavailable. type: integer trigger_wait_sum_ms: description: >- Sum of time spent waiting on trigger_* (nested subagent) calls. Nests around, not adjacent to, leaf_tool_sum_ms — do not add the two together to derive a wall-time total. nullable: true type: integer usage_source: description: >- Billing/model source used by the task. AI connections never consume Neo credits. enum: - neo - byok - ai_connections type: string required: - task_id - model - status - step_count - tool_calls - agent_triggers - usage_source - created_at type: object ToolBreakdownEntry: properties: calls: description: Number of calls to this tool type: integer total_duration_ms: description: Total duration of all calls in milliseconds type: integer type: object ToolCallHistoryEntry: properties: duration_ms: description: Duration of the call in milliseconds type: integer index: description: Sequential index of the tool call type: integer timestamp: description: Unix timestamp in milliseconds when the call was made format: int64 type: integer tool_name: description: Name of the tool called type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.