---
title: "List paid invocations owned by the authenticated vendor"
method: POST
path: "/v1/paid-invocations/list"
tags: ["billing", "paid-invocations"]
---

# List paid invocations owned by the authenticated vendor

`POST /v1/paid-invocations/list`

## Request

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

## Request body

- PaidInvocationVendorListRequest: Seller-facing HTTP contracts owned by paid invocations. OpenAPI is generated from these types; portable fields reference their canonical Runx schema.
  - `cursor` string
  - `limit` integer

## Response `200`

Typed paid-invocation result.

- PaidInvocationVendorList
  - `schema` 'runx.paid_invocation_vendor_page.v1', required
  - `items` PaidInvocationVendorSummary[], required
    - `invocation_id` InvocationId, required (unresolved $ref)
    - `offer_revision` OfferRevision, required (unresolved $ref)
    - `package_digest` PackageDigest, required (unresolved $ref)
    - `input_digest` InputDigest, required (unresolved $ref)
    - `amount_minor` AmountMinor, required (unresolved $ref)
    - `currency` Currency, required (unresolved $ref)
    - `settlement_family` SettlementFamily (unresolved $ref)
    - `payment_state` PaymentState, required (unresolved $ref)
    - `execution_state` ExecutionState, required (unresolved $ref)
    - `outcome_gate` OutcomeGate, required (unresolved $ref)
    - `payment_ref` PaidInvocationVendorReference
      - `type` Type, required (unresolved $ref)
      - `uri` string, required
    - `created_at` CreatedAt, required (unresolved $ref)
    - `updated_at` UpdatedAt, required (unresolved $ref)
    - `run` object
      - `run_ref` PaidInvocationVendorReference
        - `type` Type, required (unresolved $ref)
        - `uri` string, required
      - `attempt_count` integer, required
      - `next_attempt_at` string, date-time, required
      - `blocked_at` string, date-time
    - `terminal` object
      - `outcome` 'fulfilment' | 'refund', required
      - `delivery_state` 'pending' | 'delivered' | 'suppressed', required
      - `delivered_at` string, date-time
      - `receipt_ref` PaidInvocationVendorReference
        - `type` Type, required (unresolved $ref)
        - `uri` string, required
      - `result_ref` PaidInvocationVendorReference
        - `type` Type, required (unresolved $ref)
        - `uri` string, required
      - `refund_ref` PaidInvocationVendorReference
        - `type` Type, required (unresolved $ref)
        - `uri` string, required
      - `failure` object
        - `code` string, required
        - `message` string, required
  - `next_cursor` string

## 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)