x402

Count x402 payment attempts. (read access required; non-admin keys count only their own)

Counts x402 payment attempts, optionally filtered by status, direction and chain.

get/x402/payments/count

Request

Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
URL: ./../api/v1/x402/payments/count
Auth: API key in header token

Query parameters

status'PaymentRequired' | 'Verified' | 'Settled' | 'Failed' | 'Replayed'

direction'InboundVerify' | 'InboundSettle' | 'OutboundPayment'

side'buy' | 'sell'

Coarse side filter: buy = outbound, sell = inbound

caip2Networkstring

filterNeedsManualAction'true' | 'false'

When true, only counts attempts that require manual reconciliation: a settle that failed, threw, or was interrupted without recording its outcome (a stale Verified marker, or a stale Settled attempt missing its settlement record). Overrides the status filter.

Response

x402 payment attempt count

status'success' required

Example response

{
  "status": "success",
  "data": {
    "total": 3
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.