> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # Read settled usage report > Returns complete-period settled totals, spending groups and paginated activities. Month and today use Coordinated Universal Time (UTC). Later or unknown settlements are excluded. Follow starting_after with the same filters. ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/tenants/me/billing/reports/current openapi: 3.1.0 info: title: agentsfleet API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/tenants/me/billing/reports/current: get: tags: - Billing summary: Read settled usage report description: >- Returns complete-period settled totals, spending groups and paginated activities. Month and today use Coordinated Universal Time (UTC). Later or unknown settlements are excluded. Follow starting_after with the same filters. operationId: get_tenant_billing_report parameters: - name: period in: query description: month (default) or today, in Coordinated Universal Time (UTC). required: false schema: type: string - name: fleet_id in: query description: Exact runtime fleet identifier. required: false schema: type: string - name: model in: query description: Exact recorded model identifier. required: false schema: type: string - name: through_at in: query description: >- Inclusive cutoff with millisecond precision; defaults to now. Use the report timestamp to preserve its view. required: false schema: type: string format: date-time - name: limit in: query description: 'Page size: 1 to 100, default 50.' required: false schema: type: integer format: int32 minimum: 0 - name: starting_after in: query description: Opaque continuation for the same query and page size. required: false schema: type: string - name: activity_type in: query description: runtime or setup; absent selects both. required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BillingReport' '400': description: The request is invalid content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '401': description: Authentication is missing, invalid, or not accepted by this endpoint content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: You do not have permission for this action content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: A request or capacity limit has been reached content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: An internal server error occurred content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: A required service is unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - BearerAuth: [] components: schemas: BillingReport: type: object description: The selected account's current settled usage report. required: - period - from_at - through_at - totals - spending - filters - activities properties: activities: $ref: '#/components/schemas/BillingPage_BillingActivity' description: Bounded grouped activities, newest first. filters: $ref: '#/components/schemas/BillingChoices' description: Unfiltered period choices, never limited to the current page. from_at: type: string format: date-time description: Inclusive beginning of the selected period. period: type: string description: >- `month` or `today`, both interpreted in Coordinated Universal Time (UTC). spending: $ref: '#/components/schemas/BillingSpending' description: Full-period spending groups. through_at: type: string format: date-time description: Inclusive reporting cutoff, retained by continuations. totals: $ref: '#/components/schemas/BillingTotals' description: Totals across every matching settled line. ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - string - 'null' format: date-time description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. BillingPage_BillingActivity: type: object description: A bounded list with the standard envelope. required: - items properties: items: type: array items: type: object description: One billed fleet lease or private setup attempt. required: - id - activity_type - workspace_id - recorded_at - totals - models - postures properties: activity_type: type: string description: '`runtime` or `setup`.' fleet_id: type: - string - 'null' description: Runtime fleet identifier, retained after deletion. fleet_name: type: - string - 'null' description: Runtime name captured in the ledger; never private draft text. id: type: string description: Opaque identifier used to read its individual charges. models: type: array items: type: string description: Model identifiers recorded for this activity. postures: type: array items: type: string description: '`platform`, `self_managed`, or both when work used both.' recorded_at: type: string format: date-time description: Latest included usage-line timestamp. totals: $ref: '#/components/schemas/BillingTotals' description: Exact totals for the selected period and filters. workspace_id: type: string description: Workspace where the work occurred. description: Items on this page. next_cursor: type: - string - 'null' description: Continue with `starting_after`, or null on the final page. total: type: - integer - 'null' format: int64 description: Full matching count, or null when it was not computed. BillingChoices: type: object description: Available choices across the entire unfiltered period. required: - fleets - models properties: fleets: type: array items: $ref: '#/components/schemas/BillingFleetChoice' description: Runtime fleets and private setup, without private draft labels. models: type: array items: type: string description: Exact model identifiers recorded during the period. BillingSpending: type: object description: Full-period settled spending, independent of activity pagination. required: - by_fleet - by_model properties: by_fleet: type: array items: $ref: '#/components/schemas/BillingBreakdown' description: Grouped runtime fleets and private setup. by_model: type: array items: $ref: '#/components/schemas/BillingBreakdown' description: Grouped model identifiers. BillingTotals: type: object description: Recorded settled totals over a period, spending group or activity. required: - charged_nanos - input_tokens - output_tokens - runtime_ms - line_count - activity_count - unpriced_tokens properties: activity_count: type: integer format: int64 description: Number of billed work items. charged_nanos: $ref: '#/components/schemas/Nanos' description: Actual combined credit charge, as integer nanodollar text. input_tokens: type: integer format: int64 description: Recorded input tokens, including the cached subset. line_count: type: integer format: int64 description: Number of individually settled usage lines. output_tokens: type: integer format: int64 description: Recorded output tokens. runtime_ms: type: integer format: int64 description: Recorded runtime in milliseconds. unpriced_tokens: type: integer format: int64 description: Tokens without a published platform price. BillingFleetChoice: type: object description: A fleet choice independent of the currently selected filters. properties: id: type: - string - 'null' description: Runtime fleet identifier; null identifies setup chat. name: type: - string - 'null' description: Recorded fleet name, when available. BillingBreakdown: type: object description: One spending group across the entire selected period. required: - totals properties: key: type: - string - 'null' description: Fleet or model identifier; null identifies private setup usage. label: type: - string - 'null' description: Recorded fleet label, when available. totals: $ref: '#/components/schemas/BillingTotals' description: Exact filtered totals for this group. Nanos: type: string description: A whole number of nanos (10⁻⁹ US dollars) as a decimal string. pattern: ^(0|[1-9][0-9]*)$ securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Send a dashboard session token, an account API key (`agt_t`), or a command-line credential (`afc_`) as a Bearer token. Each endpoint lists accepted credential types. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.