{"openapi":"3.1.0","info":{"title":"AcqPath","version":"3.1.0-rc.1","description":"Observed rights declarations and bounded acquisition plans. Prices in integer micro-USDC. Reports are not licenses or legal clearance."},"paths":{"/health":{"get":{"operationId":"health","description":"","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}}}},"/v1/capabilities":{"get":{"operationId":"capabilities","description":"","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}}}},"/v1/quote":{"post":{"operationId":"quote","description":"Free quote. Positive fee buys a prepared plan, not upstream delivery.","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteInput"}}}}}},"/v1/plans/{id}":{"get":{"operationId":"redeemPlan","description":"x402 v2 paid procurement plan","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"402":{"description":"x402 v2 PAYMENT-REQUIRED"},"409":{"description":"Payment nonce reused"},"410":{"description":"Quote expired"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-AcqPath-Claim","in":"header","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","schema":{"type":"string"}}]}},"/v1/outcomes/{id}":{"post":{"operationId":"reportOutcome","description":"Client report: never a trusted training signal","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["success","latency_ms"],"properties":{"success":{"type":"boolean"},"latency_ms":{"type":"integer","minimum":0,"maximum":60000}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-AcqPath-Claim","in":"header","required":true,"schema":{"type":"string"}}]}},"/v1/rights/inspect":{"post":{"operationId":"inspectRSL","description":"Free conservative XML inspection. No external resource is fetched. ai-index uses the v3.1 profile; crawl remains legacy and cannot imply usage rights.","responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"401":{"description":"Claim or operator credential required"},"429":{"description":"Rate limit"},"503":{"description":"Unavailable or disabled"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["xml","resource","purpose"],"properties":{"xml":{"type":"string","maxLength":131072},"resource":{"type":"string","format":"uri"},"purpose":{"type":"string","enum":["ai-input","ai-train","ai-index","search","crawl"]}}}}}}}},"/v1/rights/quote":{"post":{"operationId":"quoteRightsPreflight","summary":"Prepare a report before requesting payment","description":"No financial settlement occurs. Missing declarations return available:false and charge_micro:0. UNKNOWN with a discovered declaration is disclosed before purchase.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightsInput"}}}},"responses":{"200":{"description":"Quote or unavailable result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightsQuote"}}}},"400":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/rights/reports/{id}":{"get":{"operationId":"redeemRightsReport","summary":"Redeem prepared signed report through x402 v2 exact","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{48}$"}},{"name":"X-AcqPath-Claim","in":"header","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"Signed report, signed settlement receipt and delivery proof. Verify using the independently pinned public key.","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"Base64 x402 settlement response with offer-receipt extension"}}},"400":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Unpaid exact payment challenge with signed offer","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"403":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/rights/refunds/{id}":{"post":{"operationId":"requestRightsRefund","description":"Record an idempotent refund request for operator review. This does not automatically transfer money.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-AcqPath-Claim","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"enum":["delivery_issue","incorrect_report","duplicate_purchase","other"]}}}}}},"responses":{"200":{"description":"Refund ledger status; money_sent:false"},"400":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Request rejected; inspect error code. No automatic retry of a newly signed payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/readyz":{"get":{"operationId":"readiness","responses":{"200":{"description":"Required runtime bindings, schema and evidence key checks passed. This is not payment or load validation."},"503":{"description":"Runtime configuration not ready"}}}}},"components":{"schemas":{"QuoteInput":{"type":"object","additionalProperties":false,"required":["capability","contract","baseline_provider","max_total_micro"],"properties":{"capability":{"type":"string"},"contract":{"type":"string"},"baseline_provider":{"type":"string"},"max_total_micro":{"type":"string","pattern":"^[0-9]+$"},"purpose":{"type":"string","enum":["ai-input","ai-train","search","crawl"]},"max_latency_ms":{"type":"integer","minimum":100,"maximum":60000},"require_declared_rights":{"type":"boolean","default":true}}},"RightsInput":{"type":"object","additionalProperties":false,"required":["resource","purpose","max_total_micro"],"properties":{"resource":{"type":"string","format":"uri","maxLength":2048,"description":"HTTPS resource on an explicitly reviewed origin; no query, fragment, credentials, IP literal, encoded slash or redirect."},"purpose":{"type":"string","enum":["ai-input","ai-train","ai-index","search"]},"user_class":{"type":"string","enum":["commercial","non-commercial","education","government","personal"],"default":"commercial"},"geo":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"Caller-supplied geographical context. This is not independently verified location."},"freshness_seconds":{"type":"integer","minimum":0,"maximum":3600,"default":300},"tier":{"type":"string","enum":["fresh","deep"],"default":"fresh"},"max_total_micro":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Exact integer micro-USDC budget."}}},"Error":{"type":"object","required":["error","message","request_id"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}},"RightsQuote":{"type":"object","required":["available"],"properties":{"available":{"type":"boolean"},"reason":{"type":"string"},"mode":{"const":"rights_preflight"},"quote_id":{"type":"string","pattern":"^[a-f0-9]{48}$"},"expires_at":{"type":"integer"},"fee_micro":{"type":"string"},"total_micro":{"type":"string"},"charge_micro":{"const":"0"},"decision_preview":{"enum":["ALLOW_DECLARED","DENY_DECLARED","LICENSE_REQUIRED","UNKNOWN"]},"legal_clearance":{"const":false},"redeem_url":{"type":"string","format":"uri"},"claim_token":{"type":"string","description":"Sensitive claim credential. Never put it in logs, public URLs or prompts."}}}}},"servers":[{"url":"https://api.getacqpath.com"}]}