{"openapi":"3.1.0","info":{"title":"Submitted billing reconciliation","version":"1.0.0","description":"Compare supplied billing and usage records by request ID, exact amount and currency. Flags missing or mismatched records. Does not authenticate telemetry, verify delivery or post to accounting."},"servers":[{"url":"https://agents.getardaro.com"}],"paths":{"/v1/agent-utilities/ledger-reconciliation/analyze":{"post":{"operationId":"reconcile_api_ledger","summary":"Compare supplied billing and usage records by request ID, exact amount and currency. Flags missing or mismatched records. Does not authenticate telemetry, verify delivery or post to accounting.","x-price-usdc":"0.25","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"billing_records":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"request_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])"},"amount":{"type":"string","minLength":1,"maxLength":16,"pattern":"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])"},"currency":{"type":"string","enum":["USD","USDC"]}},"required":["request_id","amount","currency"],"additionalProperties":false}},"usage_records":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"request_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])"},"amount":{"type":"string","minLength":1,"maxLength":16,"pattern":"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])"},"currency":{"type":"string","enum":["USD","USDC"]}},"required":["request_id","amount","currency"],"additionalProperties":false}}},"required":["billing_records","usage_records"],"additionalProperties":false}}}},"responses":{"200":{"description":"Settled advisory analysis; human review required.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contract_version","service_id","status","result","identities"],"properties":{"contract_version":{"const":"ardaro.agent-utilities.response.v1"},"service_id":{"const":"ardaro.reconcile_api_ledger"},"status":{"const":"review_required"},"result":{"type":"object","properties":{"tool":{"const":"reconcile_api_ledger"},"reconciliation_status":{"enum":["NO_RECORDS","MATCHED_SUBMITTED_RECORDS","DISCREPANCIES_FOUND"]},"records_compared":{"type":"integer","minimum":0,"maximum":200},"matched_record_count":{"type":"integer","minimum":0,"maximum":100},"issues":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"request_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])"},"codes":{"type":"array","minItems":1,"maxItems":1,"items":{"enum":["MISSING_BILLING_RECORD","MISSING_USAGE_RECORD","CURRENCY_MISMATCH","AMOUNT_MISMATCH"]}}},"required":["request_id","codes"],"additionalProperties":false}},"totals_by_currency":{"type":"array","maxItems":2,"items":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","USDC"]},"billing_total":{"type":"string","minLength":8,"maxLength":18,"pattern":"^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])"},"usage_total":{"type":"string","minLength":8,"maxLength":18,"pattern":"^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])"},"billing_count":{"type":"integer","minimum":0,"maximum":100},"usage_count":{"type":"integer","minimum":0,"maximum":100}},"required":["currency","billing_total","usage_total","billing_count","usage_count"],"additionalProperties":false}},"policy":{"type":"object","properties":{"advisory_only":{"const":true},"stateless":{"const":true},"submitted_records_retained":{"const":false},"caller_identity_authenticated":{"const":false},"submitted_evidence_verified":{"const":false},"external_spend_enforced":{"const":false},"downstream_payment_authorized":{"const":false},"reservation_created":{"const":false},"ledger_updated":{"const":false},"credentials_issued":{"const":false},"delivery_verified":{"const":false},"model_calls":{"const":0},"human_review_required":{"const":true},"telemetry_independently_verified":{"const":false},"scope":{"const":"Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected."}},"required":["advisory_only","stateless","submitted_records_retained","caller_identity_authenticated","submitted_evidence_verified","external_spend_enforced","downstream_payment_authorized","reservation_created","ledger_updated","credentials_issued","delivery_verified","model_calls","human_review_required","telemetry_independently_verified","scope"],"additionalProperties":false}},"required":["tool","reconciliation_status","records_compared","matched_record_count","issues","totals_by_currency","policy"],"additionalProperties":false},"identities":{"type":"object","additionalProperties":false,"required":["analysis_result_identity","payment_identity"],"properties":{"analysis_result_identity":{"type":"string","pattern":"^res_[0-9a-f]{64}(?![\\s\\S])"},"payment_identity":{"type":"object","additionalProperties":false,"required":["protocol","reference","replayed"],"properties":{"protocol":{"const":"x402-v2"},"reference":{"type":"string","pattern":"^pay_[0-9a-f]{64}(?![\\s\\S])"},"replayed":{"type":"boolean"}}}}}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64 x402 settlement receipt; validate exact route, currency, amount and payee.","schema":{"type":"string"}}}},"402":{"description":"Payment required; no analysis result returned.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string","contentEncoding":"base64"}}}},"400":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"409":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"413":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"415":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"503":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."},"504":{"description":"Invalid request, unavailable dependency or conflicting payment; no new analysis result released."}}}},"/v1/agent-utilities/ledger-reconciliation/status":{"get":{"responses":{"200":{"description":"Free cached readiness and terms."}}}},"/v1/agent-utilities/ledger-reconciliation/example":{"get":{"responses":{"200":{"description":"Fixed free synthetic input and result."}}}}}}