Verification Records

Pay for metered agent-authority verification

High-assurance x402 lane. The unpaid challenge is bounded. A paid retry must present a request-bound FLINT capability and DPoP proof before facilitator, provider, model, or record work becomes eligible.

post/api/x402/verify

Request

  • Base URL: https://flint.network
  • URL: https://flint.network/api/x402/verify
  • Auth: API key in header PAYMENT-SIGNATURE and API key in header FLINT-CAPABILITY and API key in header DPoP

Headers

PAYMENT-SIGNATUREstring

Canonical x402 v2 payment proof on the paid retry.

FLINT-CAPABILITYstring

Short-lived Passport-owner-issued capability bound to the exact paid request. Required when payment is presented.

DPoPstring

Fresh caller proof bound to the capability, request, and x402 payment proof. Required when payment is presented.

Request body

noncestring required

Unique replay-protection nonce. UUID v4 is recommended.

timestampstring date-time required

Request timestamp. Must be within the server replay-protection window.

partner_idstring

Merchant or platform identifier used for partner-scoped public IDs.

merchant_referencestring

Merchant transaction, invoice, or API access reference.

passport_idstring

Optional verified Agent Passport used by the owner-issued preflight capability.

Response

Payment settled and FLINT issued a signed verification record. Receipt state is reported separately and truthfully.

okunknown required
verdict'allow' | 'step_up' | 'review' | 'block' required
scorenumber required
confidencenumber
top_reasonsstring[]
record_idstring required
record_urlstring uri nullable required

Human-readable authorization record URL, derived by FLINT from the record ID.

receipt_urlstring uri nullable required

Machine retrieval URL for the signed settlement-receipt envelope.

receipt_page_urlstring uri nullable required

Human-readable Scout service-payment receipt URL.

signed_recordstring required

ES256 compact JWS for the authorization record.

step_upobject
complianceobject
receipt_status'issued' | 'unavailable' | 'disabled' | 'not_issued' required

Example response

{
  "record": {
    "envelope_version": "hybrid-v0"
  },
  "settlement_receipt": {
    "record": {
      "envelope_version": "hybrid-v0"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.