> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # List the tasks that used anything in a range > The selected organization's tasks that used tokens, runtime, credits or spend between from and to, under the summary's filters, a page at a time: by credits (the default), runtime, tokens, spend, start or name, descending unless order is asc. Feed next_cursor back through cursor, with the same range, filters and sort, for the next page; next_cursor is null on the last. A task's place is its usage when each page is read. A cursor minted for another range, filter or sort is 400. ## OpenAPI ````yaml api-reference/openapi.json GET /orgs/{orgID}/usage/tasks openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /orgs/{orgID}/usage/tasks: get: tags: - usage summary: List the tasks that used anything in a range description: >- The selected organization's tasks that used tokens, runtime, credits or spend between from and to, under the summary's filters, a page at a time: by credits (the default), runtime, tokens, spend, start or name, descending unless order is asc. Feed next_cursor back through cursor, with the same range, filters and sort, for the next page; next_cursor is null on the last. A task's place is its usage when each page is read. A cursor minted for another range, filter or sort is 400. operationId: listUsageTasks parameters: - in: path name: orgID required: true schema: format: uuid type: string - explode: false in: query name: from required: true schema: minLength: 1 type: string - explode: false in: query name: to required: true schema: minLength: 1 type: string - explode: false in: query name: project_id schema: minLength: 1 type: string - explode: false in: query name: user_id schema: minLength: 1 type: string - explode: false in: query name: agent_type schema: minLength: 1 type: string - explode: false in: query name: model schema: minLength: 1 type: string - explode: false in: query name: status schema: minLength: 1 type: string - explode: false in: query name: vm_size schema: minLength: 1 type: string - explode: false in: query name: cursor schema: minLength: 1 type: string - explode: false in: query name: limit schema: default: 25 format: int64 maximum: 100 minimum: 1 type: integer - explode: false in: query name: sort schema: enum: - credits - runtime - tokens - spend - started_at - name type: string - explode: false in: query name: order schema: enum: - asc - desc type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/UsageTaskListResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/UsageErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/UsageErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '422': content: application/json: schema: $ref: '#/components/schemas/UsageErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/UsageErrorResponse' description: Internal Server Error components: schemas: UsageTaskListResponse: additionalProperties: false properties: items: items: $ref: '#/components/schemas/UsageTaskSummary' type: array next_cursor: minLength: 1 type: - string - 'null' required: - items - next_cursor type: object UsageErrorResponse: additionalProperties: false properties: code: enum: - bad_gateway - bad_request - conflict - forbidden - gateway_timeout - gone - internal_error - method_not_allowed - not_acceptable - not_found - not_implemented - payment_required - precondition_failed - rate_limited - request_canceled - request_timeout - request_too_large - service_unavailable - unauthenticated - unsupported_media_type - validation_failed minLength: 1 type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code type: object UsageTaskSummary: additionalProperties: false properties: agent_run_count: format: int64 minimum: 0 type: integer agent_type: enum: - codex - claude-code - opencode type: string completed_at: format: date-time type: - string - 'null' created_by: format: uuid type: - string - 'null' created_by_name: description: >- The member the task's usage is attributed to: display name or email, or "Organization" when the task has no creator. minLength: 1 type: string credits_used: format: double minimum: 0 type: number display_status: enum: - running - awaiting_input - approved - awaiting_ci - merged - unmerged - errored - archived type: string hardware: $ref: '#/components/schemas/UsageHardwareSnapshot' model: minLength: 1 type: string pr_number: format: int64 minimum: 1 type: - integer - 'null' project_id: format: uuid type: string project_name: minLength: 1 type: string spend: $ref: '#/components/schemas/UsageSpend' started_at: format: date-time type: - string - 'null' task_count: format: int64 minimum: 0 type: integer task_id: format: uuid type: string task_name: minLength: 1 type: string tokens_in: format: int64 minimum: 0 type: integer tokens_out: format: int64 minimum: 0 type: integer total_tokens: format: int64 minimum: 0 type: integer vm_uptime_seconds: format: int64 minimum: 0 type: integer required: - task_id - task_name - created_by - created_by_name - project_id - project_name - agent_type - model - display_status - task_count - agent_run_count - tokens_in - tokens_out - total_tokens - vm_uptime_seconds - credits_used - spend type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object UsageHardwareSnapshot: additionalProperties: false properties: cpu_kind: enum: - shared - performance type: string cpus: format: int64 maximum: 16 minimum: 1 type: integer gpu_kind: enum: - a10 - l40s - a100-40gb - a100-80gb type: - string - 'null' memory_mb: format: int64 maximum: 32768 minimum: 256 type: integer volume_size_gb: format: int64 maximum: 500 minimum: 1 type: integer required: - cpu_kind - cpus - memory_mb - volume_size_gb type: object UsageSpend: additionalProperties: false properties: api_key_estimate_microdollars: format: int64 minimum: 0 type: integer money_microdollars: format: int64 minimum: 0 type: integer subscription_tokens: format: int64 minimum: 0 type: integer unpriced_slices: format: int64 minimum: 0 type: integer required: - money_microdollars - api_key_estimate_microdollars - subscription_tokens - unpriced_slices type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.