---
title: "Read an owned paid invocation"
method: POST
path: "/v1/paid-invocations/get"
tags: ["billing", "paid-invocations"]
---

# Read an owned paid invocation

`POST /v1/paid-invocations/get`

## Request

- Base URL: `https://api.runx.ai`
- URL: `https://api.runx.ai/v1/paid-invocations/get`
- Auth: HTTP bearer

## Request body

- RunxGetPaidInvocationRequest
  - `invocation_id` string, required

## Response `200`

Typed paid-invocation result.

- union
  - object
    - `status` 'admitted', required
    - `value` object, required
      - `failure` object
        - `code` string, required
        - `message` string, required
      - `invocation` object, required
        - `accepted_settlement_families` string[], required
        - `amount_minor` integer, required
        - `canonicalizer_version` 'runx.receipt.c14n.v1', required
        - `counterparty` object, required
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
          - `uri` string, required
        - `created_at` string, required
        - `currency` string, required
        - `execution_ref` object
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
          - `uri` string, required
        - `execution_state` 'unstarted' | 'queued' | 'running' | 'waiting_external' | 'cancelling' | 'succeeded' | 'failed' | 'cancelled', required
        - `expires_at` string, required
        - `external_job_ref` object
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
          - `uri` string, required
        - `idempotency` object, required
          - `binding_digest` string, required
          - `key` string, required
        - `input_digest` string, required
        - `invocation_id` string, required
        - `offer_revision` object, required
          - `input_schema_digest` string, required
          - `offer_id` string, required
          - `output_schema_digest` string, required
          - `revision` string, required
          - `revision_digest` string, required
        - `outcome_gate` 'open' | 'fulfilment_won' | 'refund_won', required
        - `package_digest` string, required
        - `payment_ref` object
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
          - `uri` string, required
        - `payment_state` 'unpaid' | 'settling' | 'settled' | 'refunded', required
        - `principal` object, required
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'principal', required
          - `uri` string, required
        - `purchaser_key` string
        - `settlement_family` string
        - `updated_at` string, required
        - `vendor_ref` object, required
          - `label` string
          - `locator` string
          - `observed_at` string
          - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
          - `provider` string
          - `type` 'principal', required
          - `uri` string, required
      - `receipt_ref` object
        - `label` string
        - `locator` string
        - `observed_at` string
        - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
        - `provider` string
        - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
        - `uri` string, required
      - `result_ref` object
        - `label` string
        - `locator` string
        - `observed_at` string
        - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
        - `provider` string
        - `type` 'thread' | 'comment' | 'event' | 'tracking_item' | 'change_request' | 'repository' | 'signal' | 'run' | 'act' | 'receipt' | 'artifact' | 'verification' | 'harness' | 'host' | 'surface' | 'target' | 'skill_binding' | 'principal' | 'scope_admission' | 'grant' | 'mandate' | 'credential' | 'webhook_delivery' | 'redaction_policy' | 'external_url' | 'connector_instance' | 'connector_operation', required
        - `uri` string, required
      - `run_ref` object
        - `label` string
        - `locator` string
        - `observed_at` string
        - `proof_kind` 'effect_evidence' | 'effect_finality' | 'credential_resolution'
        - `provider` string
        - `type` 'act', required
        - `uri` string, required
  - object
    - `code` 'offer_unavailable' | 'quote_expired' | 'terms_changed' | 'replay_conflict' | 'payment_not_authorized' | 'capacity_unavailable' | 'not_found' | 'cancellation_not_available', required
    - `reason` string, required
    - `status` 'refused', required

## Other responses

- `400`: Invalid current-V1 request envelope.
- `401`: Unauthorized.
- `403`: Missing scope or owner mismatch.
- `429`: Paid-invocation request rate limited.
- `503`: Paid-invocation service unavailable.

---

[API](https://skmtc.dev/runx/apis/runx-hosted-api.md) · [All operations](https://skmtc.dev/runx/apis/runx-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runx/apis/runx-hosted-api/revisions/6c940d8edacc?raw)