> ## Documentation Index > Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an original Usage charge > Returns the authenticated Workspace's original immutable charge for an exact Usage entry, its frozen monetary formula, bounded linked corrections and… ## OpenAPI ````yaml /openapi.json get /v1/usage/{usage_entry_id}/charge openapi: 3.1.0 info: title: Checkfu API version: '2026-08-31' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; or credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-31); the three MCP JSON-RPC transports use `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth callback carries neither Checkfu header. API keys resolve one Workspace without a request selector; authenticated responses identify it with `Checkfu-Workspace-Id`. servers: - url: https://api.checkfu.com security: - bearerAuth: [] tags: - name: organizations - name: sourceRepositories - name: tenants - name: workspaces - name: principals - name: principalGroups - name: principalAccessCredentials - name: apiKeys - name: agents - name: harnessRuntime - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: modelCredentials - name: modelRoutingProfiles - name: blueprintInstallations - name: toolSources - name: skills - name: skillSources - name: agentBlueprints - name: skillProposals - name: instructionProposals - name: catalog - name: managedTools - name: concepts - name: support - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - name: usage - name: models - name: outcomes - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: computerHeadlessOperations - name: vaults - name: apiMcp - name: a2a paths: /v1/usage/{usage_entry_id}/charge: get: tags: - usage summary: Get an original Usage charge description: >- Returns the authenticated Workspace's original immutable charge for an exact Usage entry, its frozen monetary formula, bounded linked corrections and projection state. A missing charge is a named state rather than zero. Supplier and operator notes are excluded. This readback is not payment, provider settlement or hosted qualification evidence. Checkfu support posture: alpha; hosted. Required evidence journey: usage-series. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: usage.getUsageCharge parameters: - name: usage_entry_id in: path schema: $ref: '#/components/schemas/UsageEntryId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true - name: page in: query schema: type: string pattern: ^c1_[0-9a-z]+$ required: false - name: limit in: query schema: type: integer minimum: 1 required: false responses: '200': description: Success content: application/json: schema: type: object properties: usage_entry_id: $ref: '#/components/schemas/UsageEntryId' charge: anyOf: - anyOf: - type: object properties: id: $ref: '#/components/schemas/BillingChargeId' source_usage_entry_id: $ref: '#/components/schemas/UsageEntryId' currency: type: string enum: - usd amount_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 rounding_remainder_millionths: type: integer allOf: - minimum: 0 - exclusiveMaximum: 1000000 recorded_at: type: string charge_type: type: string enum: - model provider: type: string model: type: string dimensions: $ref: '#/components/schemas/Union_300' formula_version: type: number enum: - 1 pricing: type: object properties: kind: type: string enum: - legacy_formula_rate_card rate_card_id: $ref: '#/components/schemas/BillingRateCardId' rate_card_version: type: integer exclusiveMinimum: 0 required: - kind - rate_card_id - rate_card_version additionalProperties: false required: - id - source_usage_entry_id - currency - amount_microusd - rounding_remainder_millionths - recorded_at - charge_type - provider - model - dimensions - formula_version - pricing additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/BillingChargeId' source_usage_entry_id: $ref: '#/components/schemas/UsageEntryId' currency: type: string enum: - usd amount_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 rounding_remainder_millionths: type: integer allOf: - minimum: 0 - exclusiveMaximum: 1000000 recorded_at: type: string charge_type: type: string enum: - model provider: type: string model: type: string dimensions: $ref: '#/components/schemas/Union_300' formula_version: type: number enum: - 2 pricing: type: object properties: kind: type: string enum: - customer_rate_card rate_card_id: $ref: '#/components/schemas/BillingRateCardId' rate_card_version: type: integer exclusiveMinimum: 0 required: - kind - rate_card_id - rate_card_version additionalProperties: false required: - id - source_usage_entry_id - currency - amount_microusd - rounding_remainder_millionths - recorded_at - charge_type - provider - model - dimensions - formula_version - pricing additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/BillingChargeId' source_usage_entry_id: $ref: '#/components/schemas/UsageEntryId' currency: type: string enum: - usd amount_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 rounding_remainder_millionths: type: integer allOf: - minimum: 0 - exclusiveMaximum: 1000000 recorded_at: type: string charge_type: type: string enum: - managed_tool formula_version: type: number enum: - 1 pricing: type: object properties: kind: type: string enum: - customer_rate_card rate_card_id: $ref: '#/components/schemas/BillingRateCardId' rate_card_version: type: integer exclusiveMinimum: 0 required: - kind - rate_card_id - rate_card_version additionalProperties: false tool_invocation_id: $ref: '#/components/schemas/ToolInvocationId' dimensions: type: object properties: managed_tool_calls: type: number enum: - 1 required: - managed_tool_calls additionalProperties: false required: - id - source_usage_entry_id - currency - amount_microusd - rounding_remainder_millionths - recorded_at - charge_type - formula_version - pricing - tool_invocation_id - dimensions additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/BillingChargeId' source_usage_entry_id: $ref: '#/components/schemas/UsageEntryId' currency: type: string enum: - usd amount_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 rounding_remainder_millionths: type: integer allOf: - minimum: 0 - exclusiveMaximum: 1000000 recorded_at: type: string charge_type: type: string enum: - session_runtime formula_version: type: number enum: - 1 pricing: type: object properties: kind: type: string enum: - runtime_formula formula_version: type: number enum: - 1 required: - kind - formula_version additionalProperties: false session_id: $ref: '#/components/schemas/SessionId' period_started_at: type: string period_ended_at: type: string dimensions: type: object properties: session_runtime_ms: type: integer minimum: 0 required: - session_runtime_ms additionalProperties: false required: - id - source_usage_entry_id - currency - amount_microusd - rounding_remainder_millionths - recorded_at - charge_type - formula_version - pricing - session_id - period_started_at - period_ended_at - dimensions additionalProperties: false - type: 'null' corrections: type: object properties: data: type: array items: type: object properties: id: $ref: '#/components/schemas/BillingCorrectionId' original_charge_id: $ref: '#/components/schemas/BillingChargeId' target_amount_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 target_remainder_millionths: type: integer allOf: - minimum: 0 - exclusiveMaximum: 1000000 delta_microusd: $ref: '#/components/schemas/SafeInteger' delta_remainder_millionths: type: integer allOf: - exclusiveMinimum: -1000000 - exclusiveMaximum: 1000000 recorded_at: type: string required: - id - original_charge_id - target_amount_microusd - target_remainder_millionths - delta_microusd - delta_remainder_millionths - recorded_at additionalProperties: false next_page: anyOf: - type: string - type: 'null' required: - data - next_page additionalProperties: false projection: anyOf: - type: object properties: id: $ref: '#/components/schemas/BillingProjectionId' state: $ref: '#/components/schemas/Union_302' required: - id - state additionalProperties: false - type: 'null' required: - usage_entry_id - charge - corrections - projection additionalProperties: false headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/ValidationMalformedError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - auth.invalid_key message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-invalid-key description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '403': description: >- The organization, tenant, or workspace backing this key is administratively disabled. | Deployment governance or retention policy denied the request. content: application/json: schema: anyOf: - type: object required: - error properties: error: type: object properties: type: type: string enum: - auth.disabled_tenancy message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-disabled-tenancy description: >- Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false additionalProperties: false - $ref: '#/components/schemas/PolicyDeniedError' '404': description: >- The requested resource does not exist in the resolved deployment boundary. content: application/json: schema: $ref: '#/components/schemas/ValidationNotFoundError' '429': description: Typed Checkfu wire error headers: retry-after: description: >- Delay in seconds for rate limits or deployment quotas with a known release or UTC reset boundary required: false schema: type: integer minimum: 1 content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - budget.exceeded message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#budget-exceeded description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '500': description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. content: application/json: schema: $ref: '#/components/schemas/RuntimeInternalError' security: - bearerAuth: [] components: schemas: UsageEntryId: type: string pattern: ^use_[0-9a-f]{32}$ BillingChargeId: type: string pattern: ^chg_[0-9a-f]{32}$ Union_300: anyOf: - $ref: '#/components/schemas/Objects_153' - type: object properties: unit: $ref: '#/components/schemas/Union_301' quantity_millionths: type: integer minimum: 0 required: - unit - quantity_millionths additionalProperties: false BillingRateCardId: type: string pattern: ^rate_[0-9a-f]{32}$ ToolInvocationId: type: string pattern: ^tinv_[0-9a-f]{32}$ SessionId: type: string pattern: ^sess_[0-9a-f]{32}$ BillingCorrectionId: type: string pattern: ^corr_[0-9a-f]{32}$ SafeInteger: type: integer BillingProjectionId: type: string pattern: ^bprj_[0-9a-f]{32}$ Union_302: type: string enum: - pending - sending - delivered - accepted_pending - delivery_unknown - retryable - conflict_review - dead_letter - external_adjustment_required - externally_adjusted WorkspaceId: type: string pattern: ^wrkspc_[0-9a-f]{32}$ ValidationMalformedError: type: object properties: error: type: object properties: type: type: string enum: - validation.malformed message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-malformed description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. PolicyDeniedError: type: object properties: error: type: object properties: type: type: string enum: - policy.denied message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#policy-denied description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: type: object properties: type: type: string enum: - validation.not_found message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-not-found description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. RuntimeInternalError: type: object properties: error: type: object properties: type: type: string enum: - runtime.internal message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#runtime-internal description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. Objects_153: type: object properties: uncached_input_tokens: type: integer minimum: 0 cached_input_tokens: type: integer minimum: 0 cache_write_input_tokens: type: integer minimum: 0 output_tokens: type: integer minimum: 0 reasoning_output_tokens: type: integer minimum: 0 required: - uncached_input_tokens - cached_input_tokens - cache_write_input_tokens - output_tokens - reasoning_output_tokens additionalProperties: false Union_301: type: string enum: - image - video_second - compute_second securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.