Get invoice | Gwop Docs

1	curl https://agents.gwop.io/v1/invoices/inv_01JXYZ8A4S5D6F7G8H9JKL0MNP

{
  "schema_version": "gwop.invoice.v4",
  "id": "inv_01JXYZ8A4S5D6F7G8H9JKL0MNP",
  "status": "OPEN",
  "amount": {
    "value": 1000000,
    "currency": "USDC",
    "decimals": 6,
    "display": "string"
  },
  "expires_at": "2026-03-24T11:02:33.812Z",
  "created_at": "2026-03-24T11:02:33.812Z",
  "merchant": {
    "name": "string",
    "verified": true
  },
  "status_check": {
    "url": "string",
    "method": "GET",
    "field": "status",
    "paid_value": "PAID",
    "hint": "string"
  },
  "links": {
    "landing_page": "string",
    "docs": "string"
  },
  "pricing": {
    "base_amount": 1000000,
    "gwop_fee": 1000000,
    "total": 1000000
  },
  "description": "string",
  "metadata": {},
  "payment_methods": [
    {
      "id": "x402-base",
      "kind": "x402",
      "network": "string",
      "chain": "base",
      "asset": {
        "symbol": "USDC",
        "decimals": 6,
        "contract": "string"
      },
      "pay_to": "string",
      "amount": 1000000,
      "amount_display": "string",
      "payment_url": "string",
      "recover_url": "string"
    }
  ],
  "paid_at": "2026-03-24T11:02:33.812Z",
  "paid_amount": 1000000,
  "payment_chain": "solana",
  "payment_chain_caip2": "string",
  "paid_tx_hash": "string",
  "tx_url": "string"
}

Get the public V4 checkout invoice view.

This endpoint is public and requires no authentication. Merchants usually hand public_invoice_id to agents and retain the merchant-side UUID.

Path parameters

idstringRequiredformat: "^inv_[A-Za-z0-9]{20,}$"

Public invoice ID (inv_*)

Response headers

X-Request-Idstring

Unique request identifier for debugging and support

Cache-Controlstring

Response

Invoice details

schema_versionenum

Allowed values:

idstringformat: "^inv_[A-Za-z0-9]{20,}$"

statusenum

Allowed values:

amountobject

expires_atdatetime

created_atdatetime

merchantobject

status_checkobject

linksobject

pricingobject

descriptionstring

metadatamap from strings to any

payment_methodslist of objects

paid_atdatetime

paid_amountlong>=1

USDC amount in atomic units (6 decimals). Used in REST response bodies. 1000000 = 1.00 USDC.

payment_chainenum

Allowed values:

payment_chain_caip2string

paid_tx_hashstring

tx_urlstringformat: "uri"

Errors

400

Bad Request Error

404

Not Found Error