{"openapi":"3.1.0","info":{"title":"Trade Finance & Receivables Intelligence API","version":"1.0.0","description":"Match trade documents, detect LC discrepancies, age receivables, flag assignment conflicts, and calculate discounting and exposure from supplied invoices and contracts. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/trade-finance/document-match":{"post":{"operationId":"match_trade_finance_documents","summary":"Match trade finance documents","description":"Match supplied invoices to contracts, letters of credit, and trade documents by id, amount, and parties without inventing missing links.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"invoices":[{"id":"INV-1","number":"INV-1001","issueDate":"2026-09-01","dueDate":"2026-10-31","currency":"USD","amount":100000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Widgets","contractId":"CT-1","lcId":"LC-1"}],"contracts":[{"id":"CT-1","number":"CT-9","date":"2026-08-01","currency":"USD","amount":100000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Widgets"}],"lettersOfCredit":[{"id":"LC-1","number":"LC-77","issueDate":"2026-08-15","expiryDate":"2026-11-30","currency":"USD","amount":100000,"applicant":"Buyer Co","beneficiary":"Seller Co","goods":"Widgets"}],"documents":[{"id":"DOC-1","type":"bill of lading","number":"BL-1","date":"2026-09-05","currency":"USD","amount":100000,"shipper":"Seller Co","consignee":"Buyer Co","invoiceId":"INV-1","lcId":"LC-1"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"matchedCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"invoiceNumber":{"type":"string"},"contractId":{"type":"string"},"lcId":{"type":"string"},"documentCount":{"type":"number"},"documentIds":{"type":"array","items":{"type":"string"}},"amountAligned":{"type":"boolean"},"amountCompared":{"type":"boolean"},"partiesAligned":{"type":"boolean"},"partiesCompared":{"type":"boolean"},"matched":{"type":"boolean"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"matched","invoiceCount":1,"matchedCount":1,"items":[{"invoiceId":"INV-1","invoiceNumber":"INV-1001","contractId":"CT-1","lcId":"LC-1","documentCount":1,"documentIds":["DOC-1"],"amountAligned":true,"amountCompared":true,"partiesAligned":true,"partiesCompared":true,"matched":true,"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/letter-of-credit-discrepancy-detect":{"post":{"operationId":"detect_letter_of_credit_discrepancies","summary":"Detect letter of credit discrepancies","description":"Compare supplied LC terms with linked invoices and documents. Missing required document types are flagged only from the LC list.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"lettersOfCredit":[{"id":"LC-1","number":"LC-77","issueDate":"2026-08-15","expiryDate":"2026-11-30","currency":"USD","amount":100000,"applicant":"Buyer Co","beneficiary":"Seller Co","goods":"Widgets","latestShipment":"2026-09-30","requiredDocs":["bill of lading","packing list"]}],"invoices":[{"id":"INV-1","number":"INV-1001","issueDate":"2026-09-01","currency":"USD","amount":105000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Gadgets","lcId":"LC-1"}],"documents":[{"id":"DOC-1","type":"bill of lading","number":"BL-1","date":"2026-10-05","currency":"USD","amount":105000,"shipper":"Seller Co","consignee":"Buyer Co","lcId":"LC-1"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"lcCount":{"type":"number"},"discrepancyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"lcId":{"type":"string"},"lcNumber":{"type":"string"},"invoiceCount":{"type":"number"},"documentCount":{"type":"number"},"discrepancyCount":{"type":"number"},"discrepancies":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"clean":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","lcCount":1,"discrepancyCount":5,"items":[{"lcId":"LC-1","lcNumber":"LC-77","invoiceCount":1,"documentCount":1,"discrepancyCount":5,"discrepancies":[{"code":"amount","subject":"INV-1","detail":"Invoice amount differs from LC amount."},{"code":"goods","subject":"INV-1","detail":"Goods description differs from the LC description."},{"code":"document_amount","subject":"DOC-1","detail":"Document amount differs from LC amount."},{"code":"shipment_date","subject":"DOC-1","detail":"Shipment or bill date is after the LC latest shipment date."},{"code":"missing_document","subject":"packing list","detail":"A required LC document type was not found in supplied documents."}],"clean":false,"discrepancyInvented":false,"creditDecision":false,"financingApproved":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"conflict","code":"amount","subject":"INV-1","detail":"Invoice amount differs from LC amount."},{"kind":"conflict","code":"goods","subject":"INV-1","detail":"Goods description differs from the LC description."},{"kind":"conflict","code":"document_amount","subject":"DOC-1","detail":"Document amount differs from LC amount."},{"kind":"conflict","code":"shipment_date","subject":"DOC-1","detail":"Shipment or bill date is after the LC latest shipment date."},{"kind":"conflict","code":"missing_document","subject":"packing list","detail":"A required LC document type was not found in supplied documents."}],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/invoice-financing-readiness":{"post":{"operationId":"assess_invoice_financing_readiness","summary":"Assess invoice financing readiness","description":"Score supplied invoices for completeness of identifiers, amounts, parties, and dates. This is not a financing approval.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"invoices":[{"id":"INV-1","number":"INV-1001","issueDate":"2026-09-01","dueDate":"2026-10-31","currency":"USD","amount":100000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Widgets","contractId":"CT-1"},{"id":"INV-2","number":"INV-1002","currency":"USD","amount":50000,"buyer":"Buyer Co"}],"contracts":[{"id":"CT-1","number":"CT-9","date":"2026-08-01","currency":"USD","amount":100000,"buyer":"Buyer Co","seller":"Seller Co"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"readyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"invoiceNumber":{"type":"string"},"score":{"type":"number"},"readiness":{"type":"string"},"missingFields":{"type":"array","items":{}},"hasContract":{"type":"boolean"},"hasLc":{"type":"boolean"},"documentCount":{"type":"number"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"assessed","invoiceCount":2,"readyCount":1,"items":[{"invoiceId":"INV-1","invoiceNumber":"INV-1001","score":100,"readiness":"ready","missingFields":[],"hasContract":true,"hasLc":false,"documentCount":0,"creditDecision":false,"financingApproved":false,"amountInvented":false},{"invoiceId":"INV-2","invoiceNumber":"INV-1002","score":50,"readiness":"incomplete","missingFields":["seller","issue_date","due_date","goods"],"hasContract":false,"hasLc":false,"documentCount":0,"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"missing","code":"seller","subject":"INV-2","detail":"Seller was not supplied."},{"kind":"missing","code":"issue_date","subject":"INV-2","detail":"Issue date was not supplied."},{"kind":"missing","code":"due_date","subject":"INV-2","detail":"Due date was not supplied."},{"kind":"missing","code":"goods","subject":"INV-2","detail":"Goods description was not supplied."}],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/receivable-aging-risk-analyze":{"post":{"operationId":"analyze_receivable_aging_risk","summary":"Analyze receivable aging risk","description":"Bucket supplied invoice outstanding amounts by days past due from the as-of date. Missing due dates stay unlabeled.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"asOf":"2026-11-01","invoices":[{"id":"INV-1","number":"INV-1001","dueDate":"2026-10-15","currency":"USD","amount":100000,"outstanding":100000,"buyer":"Buyer Co","seller":"Seller Co"},{"id":"INV-2","number":"INV-1002","dueDate":"2026-09-01","currency":"USD","amount":40000,"outstanding":40000,"buyer":"Other Co","seller":"Seller Co"},{"id":"INV-3","number":"INV-1003","dueDate":"2026-11-15","currency":"USD","amount":25000,"outstanding":25000,"buyer":"Buyer Co","seller":"Seller Co"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"asOf":{"type":"string"},"invoiceCount":{"type":"number"},"buckets":{"type":"object","properties":{"current":{"type":"number"},"1-30":{"type":"number"},"31-60":{"type":"number"},"61-90":{"type":"number"},"90+":{"type":"number"},"unknown":{"type":"number"}},"additionalProperties":true},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"invoiceNumber":{"type":"string"},"buyer":{"type":"string"},"currency":{"type":"string"},"dueDate":{"type":"string"},"asOf":{"type":"string"},"daysPastDue":{"type":"number"},"daysPastDueSupplied":{"type":"boolean"},"outstanding":{"type":"number"},"outstandingSupplied":{"type":"boolean"},"bucket":{"type":"string"},"risk":{"type":"string"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","asOf":"2026-11-01","invoiceCount":3,"buckets":{"current":25000,"1-30":100000,"31-60":0,"61-90":40000,"90+":0,"unknown":0},"items":[{"invoiceId":"INV-1","invoiceNumber":"INV-1001","buyer":"Buyer Co","currency":"USD","dueDate":"2026-10-15","asOf":"2026-11-01","daysPastDue":17,"daysPastDueSupplied":true,"outstanding":100000,"outstandingSupplied":true,"bucket":"1-30","risk":"lower","creditDecision":false,"financingApproved":false,"amountInvented":false},{"invoiceId":"INV-2","invoiceNumber":"INV-1002","buyer":"Other Co","currency":"USD","dueDate":"2026-09-01","asOf":"2026-11-01","daysPastDue":61,"daysPastDueSupplied":true,"outstanding":40000,"outstandingSupplied":true,"bucket":"61-90","risk":"elevated","creditDecision":false,"financingApproved":false,"amountInvented":false},{"invoiceId":"INV-3","invoiceNumber":"INV-1003","buyer":"Buyer Co","currency":"USD","dueDate":"2026-11-15","asOf":"2026-11-01","daysPastDue":-14,"daysPastDueSupplied":true,"outstanding":25000,"outstandingSupplied":true,"bucket":"current","risk":"lower","creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/invoice-assignment-conflict-detect":{"post":{"operationId":"detect_invoice_assignment_conflicts","summary":"Detect invoice assignment conflicts","description":"Flag when the same invoice id or number is assigned to more than one assignee in the supplied set.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"assignments":[{"id":"ASG-1","invoiceId":"INV-1","assignee":"Bank A","assignor":"Seller Co","date":"2026-09-10","amount":100000,"currency":"USD"},{"id":"ASG-2","invoiceId":"INV-1","assignee":"Factor B","assignor":"Seller Co","date":"2026-09-12","amount":100000,"currency":"USD"},{"id":"ASG-3","invoiceId":"INV-2","assignee":"Bank A","assignor":"Seller Co","date":"2026-09-11","amount":40000,"currency":"USD"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"conflictCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"invoiceKey":{"type":"string"},"assignmentCount":{"type":"number"},"assignees":{"type":"array","items":{"type":"string"}},"conflict":{"type":"boolean"},"assignments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"assignee":{"type":"string"},"assignor":{"type":"string"},"date":{"type":"string"},"amount":{"type":"number"},"amountSupplied":{"type":"boolean"},"currency":{"type":"string"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","invoiceCount":2,"conflictCount":1,"items":[{"invoiceKey":"inv-1","assignmentCount":2,"assignees":["Bank A","Factor B"],"conflict":true,"assignments":[{"id":"ASG-1","assignee":"Bank A","assignor":"Seller Co","date":"2026-09-10","amount":100000,"amountSupplied":true,"currency":"USD"},{"id":"ASG-2","assignee":"Factor B","assignor":"Seller Co","date":"2026-09-12","amount":100000,"amountSupplied":true,"currency":"USD"}],"creditDecision":false,"financingApproved":false,"amountInvented":false},{"invoiceKey":"inv-2","assignmentCount":1,"assignees":["Bank A"],"conflict":false,"assignments":[{"id":"ASG-3","assignee":"Bank A","assignor":"Seller Co","date":"2026-09-11","amount":40000,"amountSupplied":true,"currency":"USD"}],"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"conflict","code":"assignment_conflict","subject":"inv-1","detail":"The same invoice is assigned to more than one assignee in the supplied set."}],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/document-party-consistency":{"post":{"operationId":"check_trade_document_party_consistency","summary":"Check trade document party consistency","description":"Compare buyer, seller, applicant, beneficiary, shipper, and consignee fields across linked invoices, contracts, LCs, and documents.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"invoices":[{"id":"INV-1","number":"INV-1001","buyer":"Buyer Co","seller":"Seller Co","contractId":"CT-1","lcId":"LC-1"}],"contracts":[{"id":"CT-1","buyer":"Buyer Co","seller":"Seller Co"}],"lettersOfCredit":[{"id":"LC-1","applicant":"Buyer Co","beneficiary":"Seller Co"}],"documents":[{"id":"DOC-1","type":"bill of lading","shipper":"Other Shipper","consignee":"Buyer Co","invoiceId":"INV-1"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"consistentCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"buyer":{"type":"string"},"seller":{"type":"string"},"checkCount":{"type":"number"},"conflictCount":{"type":"number"},"consistent":{"type":"boolean"},"conflicts":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","invoiceCount":1,"consistentCount":0,"items":[{"invoiceId":"INV-1","buyer":"Buyer Co","seller":"Seller Co","checkCount":6,"conflictCount":1,"consistent":false,"conflicts":[{"field":"shipper_DOC-1","detail":"Invoice seller vs document shipper DOC-1"}],"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"conflict","code":"shipper_DOC-1","subject":"INV-1","detail":"Invoice seller vs document shipper DOC-1 do not match."}],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/export-payment-term-risk":{"post":{"operationId":"assess_export_payment_term_risk","summary":"Assess export payment term risk","description":"Label supplied payment terms as lower, moderate, higher, or unclassified from wording only. Not a credit decision.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"invoices":[{"id":"INV-1","buyer":"Buyer Co","paymentTerms":"Net 30","incoterm":"FOB","country":"DE"},{"id":"INV-2","buyer":"Other Co","paymentTerms":"Open account Net 90","incoterm":"CIF","country":"BR"},{"id":"INV-3","buyer":"Cash Co","paymentTerms":"CAD sight","incoterm":"EXW","country":"US"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"itemCount":{"type":"number"},"higherCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"counterparty":{"type":"string"},"country":{"type":"string"},"paymentTerms":{"type":"string"},"incoterm":{"type":"string"},"risk":{"type":"string"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"assessed","itemCount":3,"higherCount":1,"items":[{"id":"INV-1","kind":"invoice","counterparty":"Buyer Co","country":"DE","paymentTerms":"Net 30","incoterm":"FOB","risk":"lower","creditDecision":false,"financingApproved":false,"amountInvented":false},{"id":"INV-2","kind":"invoice","counterparty":"Other Co","country":"BR","paymentTerms":"Open account Net 90","incoterm":"CIF","risk":"higher","creditDecision":false,"financingApproved":false,"amountInvented":false},{"id":"INV-3","kind":"invoice","counterparty":"Cash Co","country":"US","paymentTerms":"CAD sight","incoterm":"EXW","risk":"lower","creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/credit-exposure-calculate":{"post":{"operationId":"calculate_trade_credit_exposure","summary":"Calculate trade credit exposure","description":"Sum supplied outstanding or face amounts by buyer and currency. Missing amounts are not invented.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"invoices":[{"id":"INV-1","buyer":"Buyer Co","currency":"USD","amount":100000,"outstanding":80000},{"id":"INV-2","buyer":"Buyer Co","currency":"USD","amount":40000,"outstanding":40000},{"id":"INV-3","buyer":"Other Co","currency":"EUR","amount":25000,"outstanding":25000}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"counterpartyCount":{"type":"number"},"totalOutstanding":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"buyer":{"type":"string"},"currency":{"type":"string"},"invoiceCount":{"type":"number"},"outstanding":{"type":"number"},"outstandingSupplied":{"type":"boolean"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"calculated","counterpartyCount":2,"totalOutstanding":145000,"items":[{"buyer":"Buyer Co","currency":"USD","invoiceCount":2,"outstanding":120000,"outstandingSupplied":true,"creditDecision":false,"financingApproved":false,"amountInvented":false},{"buyer":"Other Co","currency":"EUR","invoiceCount":1,"outstanding":25000,"outstandingSupplied":true,"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/invoice-discounting-calculate":{"post":{"operationId":"calculate_invoice_discounting","summary":"Calculate invoice discounting","description":"Calculate simple discount and proceeds from supplied face amounts, due dates, as-of date, and discount rate. Not a financing approval.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"asOf":"2026-10-01","discountRatePct":6,"invoices":[{"id":"INV-1","number":"INV-1001","dueDate":"2026-12-30","currency":"USD","amount":100000},{"id":"INV-2","number":"INV-1002","dueDate":"2026-11-15","currency":"USD","amount":50000}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"invoiceNumber":{"type":"string"},"currency":{"type":"string"},"asOf":{"type":"string"},"dueDate":{"type":"string"},"faceAmount":{"type":"number"},"faceAmountSupplied":{"type":"boolean"},"tenorDays":{"type":"number"},"tenorDaysSupplied":{"type":"boolean"},"discountRatePct":{"type":"number"},"discountRateSupplied":{"type":"boolean"},"discountAmount":{"type":"number"},"discountAmountSupplied":{"type":"boolean"},"proceeds":{"type":"number"},"proceedsSupplied":{"type":"boolean"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"calculated","invoiceCount":2,"items":[{"invoiceId":"INV-1","invoiceNumber":"INV-1001","currency":"USD","asOf":"2026-10-01","dueDate":"2026-12-30","faceAmount":100000,"faceAmountSupplied":true,"tenorDays":90,"tenorDaysSupplied":true,"discountRatePct":6,"discountRateSupplied":true,"discountAmount":1500,"discountAmountSupplied":true,"proceeds":98500,"proceedsSupplied":true,"creditDecision":false,"financingApproved":false,"amountInvented":false},{"invoiceId":"INV-2","invoiceNumber":"INV-1002","currency":"USD","asOf":"2026-10-01","dueDate":"2026-11-15","faceAmount":50000,"faceAmountSupplied":true,"tenorDays":45,"tenorDaysSupplied":true,"discountRatePct":6,"discountRateSupplied":true,"discountAmount":375,"discountAmountSupplied":true,"proceeds":49625,"proceedsSupplied":true,"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/trade-finance/evidence-package":{"post":{"operationId":"build_trade_finance_evidence_package","summary":"Build trade finance evidence package","description":"Assemble document match, LC discrepancy, readiness, aging, assignment, party, term, exposure, and discounting summaries from the supplied set.","tags":["trade-finance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"parties":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80}},"additionalProperties":false}},"invoices":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"dueDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"outstanding":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"contractId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"contracts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"buyer":{"type":"string","maxLength":200},"seller":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"paymentTerms":{"type":"string","maxLength":200},"incoterm":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"lettersOfCredit":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"issueDate":{"type":"string","maxLength":40},"expiryDate":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"applicant":{"type":"string","maxLength":200},"beneficiary":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"latestShipment":{"type":"string","maxLength":40},"requiredDocs":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":120}},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"documents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"type":{"type":"string","maxLength":80},"number":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"shipper":{"type":"string","maxLength":200},"consignee":{"type":"string","maxLength":200},"goods":{"type":"string","maxLength":400},"invoiceId":{"type":"string","maxLength":80},"lcId":{"type":"string","maxLength":80},"contractId":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"assignments":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"invoiceId":{"type":"string","maxLength":80},"invoiceNumber":{"type":"string","maxLength":80},"assignee":{"type":"string","maxLength":200},"assignor":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"discountRatePct":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"example":{"asOf":"2026-11-01","discountRatePct":6,"invoices":[{"id":"INV-1","number":"INV-1001","issueDate":"2026-09-01","dueDate":"2026-10-15","currency":"USD","amount":100000,"outstanding":100000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Widgets","paymentTerms":"Net 30","contractId":"CT-1","lcId":"LC-1"}],"contracts":[{"id":"CT-1","number":"CT-9","date":"2026-08-01","currency":"USD","amount":100000,"buyer":"Buyer Co","seller":"Seller Co","goods":"Widgets","paymentTerms":"Net 30"}],"lettersOfCredit":[{"id":"LC-1","number":"LC-77","issueDate":"2026-08-15","expiryDate":"2026-11-30","currency":"USD","amount":100000,"applicant":"Buyer Co","beneficiary":"Seller Co","goods":"Widgets","requiredDocs":["bill of lading"]}],"documents":[{"id":"DOC-1","type":"bill of lading","number":"BL-1","date":"2026-09-05","currency":"USD","amount":100000,"shipper":"Seller Co","consignee":"Buyer Co","invoiceId":"INV-1","lcId":"LC-1"}],"assignments":[{"id":"ASG-1","invoiceId":"INV-1","assignee":"Bank A","assignor":"Seller Co","date":"2026-09-10","amount":100000,"currency":"USD"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"invoiceCount":{"type":"number"},"contractCount":{"type":"number"},"lcCount":{"type":"number"},"documentCount":{"type":"number"},"assignmentCount":{"type":"number"},"sections":{"type":"object","properties":{"documentMatch":{"type":"object","properties":{"matchedCount":{"type":"number"},"invoiceCount":{"type":"number"}},"additionalProperties":true},"lcDiscrepancies":{"type":"object","properties":{"lcCount":{"type":"number"},"discrepancyCount":{"type":"number"}},"additionalProperties":true},"financingReadiness":{"type":"object","properties":{"readyCount":{"type":"number"},"invoiceCount":{"type":"number"}},"additionalProperties":true},"aging":{"type":"object","properties":{"asOf":{"type":"string"},"buckets":{"type":"object","properties":{"current":{"type":"number"},"1-30":{"type":"number"},"31-60":{"type":"number"},"61-90":{"type":"number"},"90+":{"type":"number"},"unknown":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"assignmentConflicts":{"type":"object","properties":{"conflictCount":{"type":"number"}},"additionalProperties":true},"partyConsistency":{"type":"object","properties":{"consistentCount":{"type":"number"}},"additionalProperties":true},"paymentTermRisk":{"type":"object","properties":{"higherCount":{"type":"number"}},"additionalProperties":true},"creditExposure":{"type":"object","properties":{"counterpartyCount":{"type":"number"},"totalOutstanding":{"type":"number"}},"additionalProperties":true},"discounting":{"type":"object","properties":{"invoiceCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"items":{"type":"array","items":{"type":"object","properties":{"invoiceId":{"type":"string"},"invoiceNumber":{"type":"string"},"contractId":{"type":"string"},"lcId":{"type":"string"},"documentCount":{"type":"number"},"documentIds":{"type":"array","items":{"type":"string"}},"amountAligned":{"type":"boolean"},"amountCompared":{"type":"boolean"},"partiesAligned":{"type":"boolean"},"partiesCompared":{"type":"boolean"},"matched":{"type":"boolean"},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"}},"additionalProperties":true}},"creditDecision":{"type":"boolean"},"financingApproved":{"type":"boolean"},"amountInvented":{"type":"boolean"},"discrepancyInvented":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"packaged","invoiceCount":1,"contractCount":1,"lcCount":1,"documentCount":1,"assignmentCount":1,"sections":{"documentMatch":{"matchedCount":1,"invoiceCount":1},"lcDiscrepancies":{"lcCount":1,"discrepancyCount":0},"financingReadiness":{"readyCount":1,"invoiceCount":1},"aging":{"asOf":"2026-11-01","buckets":{"current":0,"1-30":100000,"31-60":0,"61-90":0,"90+":0,"unknown":0}},"assignmentConflicts":{"conflictCount":0},"partyConsistency":{"consistentCount":1},"paymentTermRisk":{"higherCount":0},"creditExposure":{"counterpartyCount":1,"totalOutstanding":100000},"discounting":{"invoiceCount":1}},"items":[{"invoiceId":"INV-1","invoiceNumber":"INV-1001","contractId":"CT-1","lcId":"LC-1","documentCount":1,"documentIds":["DOC-1"],"amountAligned":true,"amountCompared":true,"partiesAligned":true,"partiesCompared":true,"matched":true,"creditDecision":false,"financingApproved":false,"amountInvented":false}],"creditDecision":false,"financingApproved":false,"amountInvented":false,"discrepancyInvented":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Invoices, contracts, letters of credit, trade documents, and assignments are copied only from labeled fields supplied by the caller, or from key-free public World Bank trade responses when requested.","No paid trade-finance data provider is used and no API key is required.","Missing amounts, due dates, parties, and document fields are not invented.","Financing readiness and discounting figures are descriptive calculations only. A credit or financing decision is never produced.","Discrepancy and conflict findings compare supplied fields only and do not contact banks or registries."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}