---
title: "Private issuer-wallet invoice ledger, immutable face amount and parties, run-reference binding and recorded issuer review. References are not independently verified. No bill delivery, payment collection or spending authority."
method: POST
path: "/api/agent-invoice-rail"
---

# Private issuer-wallet invoice ledger, immutable face amount and parties, run-reference binding and recorded issuer review. References are not independently verified. No bill delivery, payment collection or spending authority.

`POST /api/agent-invoice-rail`

## Request

- Base URL: `https://weverlabs.com`
- URL: `https://weverlabs.com/api/agent-invoice-rail`
- Auth: none declared

Direct access uses x402 Base USDC settlement or the verified-wallet free tier. Private issuer-wallet invoice ledger, immutable face amount and parties, run-reference binding and recorded issuer review. References are not independently verified. No bill delivery, payment collection or spending authority. Every invoice operation also requires a signed issuer-wallet ownership proof. The API access fee is separate from any inspected payment or recorded invoice amount.

## Request body

- union
  - object
    - `schema_version` '1.0.0', required
    - `mode` 'create_invoice_reference', required
    - `idempotency_key` string, required
    - `buyer_reference` string, required
    - `buyer_wallet` string, required
    - `rail_key` string, required
    - `amount_atomic` string, required
    - `expires_at` integer, required
    - `description` string, required
    - `usage` 'synthetic' | 'operational', required
    - `invoice_id` string
    - `expected_version` integer
    - `run_binding` object
      - `run_id` string, required
      - `receipt_reference` string, required
      - `return_package_reference` string, required
      - `receipt_sha256` string, required
      - `return_package_sha256` string, required
    - `decision` 'approve' | 'reject'
    - `note` string
  - object
    - `schema_version` '1.0.0', required
    - `mode` 'read_invoice', required
    - `idempotency_key` string
    - `buyer_reference` string
    - `buyer_wallet` string
    - `rail_key` string
    - `amount_atomic` string
    - `expires_at` integer
    - `description` string
    - `usage` 'synthetic' | 'operational'
    - `invoice_id` string, required
    - `expected_version` integer
    - `run_binding` object
      - `run_id` string, required
      - `receipt_reference` string, required
      - `return_package_reference` string, required
      - `receipt_sha256` string, required
      - `return_package_sha256` string, required
    - `decision` 'approve' | 'reject'
    - `note` string
  - object
    - `schema_version` '1.0.0', required
    - `mode` 'bind_invoice_to_run', required
    - `idempotency_key` string, required
    - `buyer_reference` string
    - `buyer_wallet` string
    - `rail_key` string
    - `amount_atomic` string
    - `expires_at` integer
    - `description` string
    - `usage` 'synthetic' | 'operational'
    - `invoice_id` string, required
    - `expected_version` integer, required
    - `run_binding` object, required
      - `run_id` string, required
      - `receipt_reference` string, required
      - `return_package_reference` string, required
      - `receipt_sha256` string, required
      - `return_package_sha256` string, required
    - `decision` 'approve' | 'reject'
    - `note` string
  - object
    - `schema_version` '1.0.0', required
    - `mode` 'review_invoice', required
    - `idempotency_key` string, required
    - `buyer_reference` string
    - `buyer_wallet` string
    - `rail_key` string
    - `amount_atomic` string
    - `expires_at` integer
    - `description` string
    - `usage` 'synthetic' | 'operational'
    - `invoice_id` string, required
    - `expected_version` integer, required
    - `run_binding` object
      - `run_id` string, required
      - `receipt_reference` string, required
      - `return_package_reference` string, required
      - `receipt_sha256` string, required
      - `return_package_sha256` string, required
    - `decision` 'approve' | 'reject', required
    - `note` string, required

## Response `200`

Private issuer-wallet invoice ledger, immutable face amount and parties, run-reference binding and recorded issuer review. References are not independently verified. No bill delivery, payment collection or spending authority.

- object
  - `ok` unknown, required
  - `service_id` 'com.weverlabs/agent-invoice-rail', required
  - `version` '1.0.0', required
  - `operation` 'create_invoice_reference' | 'read_invoice' | 'bind_invoice_to_run' | 'review_invoice', required
  - `execution` 'completed', required
  - `input_sha256` string, required
  - `result_sha256` string, required
  - `result` object, required
    - `contract_version` '1.0.0', required
    - `artifact_state` 'persisted_invoice_record', required
    - `persisted` unknown, required
    - `observed_at` integer, required
    - `expired` boolean, required
    - `invoice` object, required
      - `invoice_id` string, required
      - `issuer_wallet` string, required
      - `buyer_reference` string, required
      - `buyer_wallet` string, required
      - `network` 'eip155:8453', required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `rail_key` string, required
      - `description` string, required
      - `usage` 'synthetic' | 'operational', required
      - `usage_source` 'issuer_declared', required
      - `created_at` integer, required
      - `updated_at` integer, required
      - `expires_at` integer, required
      - `version` integer, required
      - `billing_operation_key` string, required
      - `billing_request_hash` string, required
      - `review_status` 'review_required' | 'approved' | 'rejected', required
      - `run_binding` object, nullable, required
        - `run_id` string, required
        - `receipt_reference` string, required
        - `return_package_reference` string, required
        - `receipt_sha256` string, required
        - `return_package_sha256` string, required
      - `run_binding_sha256` string, nullable, required
      - `review` object, nullable, required
        - `decision` 'approve' | 'reject', required
        - `note` string, required
        - `reviewer_wallet` string, required
        - `reviewed_at` integer, required
      - `events` object[], required
        - `sequence` integer, required
        - `type` 'created' | 'run_bound' | 'reviewed', required
        - `at` integer, required
        - `actor_wallet` string, required
        - `request_sha256` string, required
    - `reference_verification` 'issuer_supplied_not_independently_verified', required
    - `payment_state` 'not_collected', required
    - `delivery_state` 'not_sent', required
    - `financial_transfer_performed` unknown, required
    - `payment_permission_granted` unknown, required
    - `api_access_fee_separate_from_invoice_amount` unknown, required
  - `provenance` object, required
    - `kind` 'authenticated_durable_invoice_record', required
    - `source` 'Wever Labs', required
    - `signature` 'none', required
    - `scope` 'Private issuer-wallet invoice ledger, immutable face amount and parties, run-reference binding and recorded issuer review. References are not independently verified. No bill delivery, payment collection or spending authority.', required

## Other responses

- `400`: Malformed, unknown, inconsistent or out-of-bounds input rejected before billing
- `401`: Signed issuer-wallet ownership proof required
- `402`: x402 v2 payment or verified-wallet shared free allowance required; read PAYMENT-REQUIRED
- `404`: Invoice not found for issuer wallet
- `409`: Idempotency conflict, stale invoice version or disallowed transition
- `413`: Request or result exceeds limits
- `415`: JSON content type required
- `503`: Payment, chain observation or durable storage dependency unavailable

---

[API](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api.md) · [All operations](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api/revisions/e4eed0d1f6e3?raw)