The complete request path

Check coverage first

Read the native_services entry for rights.preflight.v1. Coverage is an explicit allowlist; an allowed domain does not imply that every resource has usable declarations.

A URL must be canonical HTTPS without credentials, query, fragment, encoded slash or non-standard port. The buyer owns the use-context supplied to the service.

GET https://api.getacqpath.com/v1/capabilities

Prepare a quote

POST resource, purpose and max_total_micro to the quote endpoint. This may use remote metadata and consume a quota, but performs no settlement.

If no verifiable declaration is found, the reference service returns available:false with NO_VERIFIABLE_DECLARATION and no report fee. UNKNOWN with a discovered but unsupported declaration can be disclosed as a purchasable report; inspect the preview.

POST /v1/rights/quote
{ "resource": "https://SUPPORTED-HOST/REAL-RESOURCE",
  "purpose": "ai-input", "tier": "fresh",
  "max_total_micro": "20000" }

The placeholder is not a demonstrated supported resource.

Purchase and resume safely

The quote includes a private claim and quote-specific redeem URL. The SDK verifies a signed offer, fixes the payee/network/asset/amount, invokes a buyer-controlled signer and stores a checkpoint before submitting the signed payload.

After an ambiguous response, resume the same checkpoint. Do not create a second purchase or sign again to clear an error. The current operator-reported reconciliation state is degraded, so manual recovery may be necessary.

Never expose the claim, payment signature or checkpoint to a public registry or language model.