{"openapi":"3.1.0","info":{"title":"Corporate Ownership, Sanctions & Investigation API","version":"1.0.0","description":"Normalize registry records, map ownership chains, resolve name variants, and compare sanctions or enforcement lists from supplied public-format records without treating uncertain matches as confirmed. 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/corporate-intelligence/registry-record-normalize":{"post":{"operationId":"normalize_corporate_registry_records","summary":"Normalize corporate registry records","description":"Normalize supplied company registry fields and legal-name tokens. Missing identifiers stay blank rather than invented.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC","tradingName":"Example Construction","registry":"OpenCorporates excerpt","registryNumber":"12345678","country":"US","status":"active","source":"Caller-supplied registry excerpt","sourceUrl":"https://example.invalid/registry/12345678"},{"id":"CO-2","legalName":"Other Holdings Limited","registry":"Caller-supplied Companies House excerpt","registryNumber":"87654321","country":"GB","status":"active","source":"Caller-supplied registry excerpt"}]}}}},"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"},"companyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"legalName":{"type":"string"},"tradingName":{"type":"string"},"normalizedName":{"type":"string"},"registry":{"type":"string"},"registryNumber":{"type":"string"},"lei":{"type":"string"},"country":{"type":"string"},"status":{"type":"string"},"address":{"type":"string"},"incorporatedOn":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"normalized","companyCount":2,"items":[{"id":"CO-1","legalName":"Example Construction LLC","tradingName":"Example Construction","normalizedName":"example construction","registry":"OpenCorporates excerpt","registryNumber":"12345678","lei":"","country":"US","status":"active","address":"","incorporatedOn":"","source":"Caller-supplied registry excerpt","sourceUrl":"https://example.invalid/registry/12345678","uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false},{"id":"CO-2","legalName":"Other Holdings Limited","tradingName":"","normalizedName":"other holdings","registry":"Caller-supplied Companies House excerpt","registryNumber":"87654321","lei":"","country":"GB","status":"active","address":"","incorporatedOn":"","source":"Caller-supplied registry excerpt","sourceUrl":"","uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/company-identity-cross-check":{"post":{"operationId":"cross_check_company_identity","summary":"Cross-check company identity","description":"Compare supplied company records by registry number, LEI, and normalized names. Possible matches are never treated as confirmed.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC","registryNumber":"12345678","registry":"US","country":"US"},{"id":"CO-2","legalName":"Example Construction","registryNumber":"12345678","registry":"alt","country":"US"},{"id":"CO-3","legalName":"Example Constructing Co","registry":"US","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"},"pairCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"leftId":{"type":"string"},"rightId":{"type":"string"},"leftName":{"type":"string"},"rightName":{"type":"string"},"leftRegistry":{"type":"string"},"rightRegistry":{"type":"string"},"matchKind":{"type":"string"},"score":{"type":"number"},"confirmedSameIdentity":{"type":"boolean"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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","pairCount":1,"items":[{"leftId":"CO-1","rightId":"CO-2","leftName":"Example Construction LLC","rightName":"Example Construction","leftRegistry":"US","rightRegistry":"alt","matchKind":"exact","score":1,"confirmedSameIdentity":true,"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"identity_aligned","subject":"CO-1|CO-2","detail":"Records share an exact normalized name or identifier."}],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/director-history":{"post":{"operationId":"list_corporate_director_history","summary":"List corporate director history","description":"Group supplied director appointments by company into a chronological history without inventing missing dates.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"directors":[{"id":"DIR-1","companyId":"CO-1","companyName":"Example Construction LLC","name":"Ada Example","role":"director","appointedOn":"2020-01-15","source":"Caller-supplied filing"},{"id":"DIR-2","companyId":"CO-1","companyName":"Example Construction LLC","name":"Ben Example","role":"secretary","appointedOn":"2021-06-01","resignedOn":"2024-03-01","source":"Caller-supplied filing"}]}}}},"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"},"companyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"companyKey":{"type":"string"},"companyId":{"type":"string"},"companyName":{"type":"string"},"appointmentCount":{"type":"number"},"appointments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"normalizedName":{"type":"string"},"role":{"type":"string"},"appointedOn":{"type":"string"},"resignedOn":{"type":"string"},"active":{"type":"boolean"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"listed","companyCount":1,"items":[{"companyKey":"co-1","companyId":"CO-1","companyName":"Example Construction LLC","appointmentCount":2,"appointments":[{"id":"DIR-1","name":"Ada Example","normalizedName":"ada example","role":"director","appointedOn":"2020-01-15","resignedOn":"","active":true,"source":"Caller-supplied filing","sourceUrl":""},{"id":"DIR-2","name":"Ben Example","normalizedName":"ben example","role":"secretary","appointedOn":"2021-06-01","resignedOn":"2024-03-01","active":false,"source":"Caller-supplied filing","sourceUrl":""}],"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/company-ownership-chain-map":{"post":{"operationId":"map_company_ownership_chains","summary":"Map company ownership chains","description":"Walk supplied parent-child ownership edges into chains. Missing ownership percents are labeled, not invented.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"ownership":[{"id":"OWN-1","parentId":"CO-HOLD","parentName":"HoldCo Ltd","childId":"CO-1","childName":"Example Construction LLC","percent":100,"asOf":"2026-01-01","source":"Caller-supplied ownership excerpt"},{"id":"OWN-2","parentId":"CO-ULT","parentName":"Ultimate Parent SA","childId":"CO-HOLD","childName":"HoldCo Ltd","percent":75,"asOf":"2026-01-01","source":"Caller-supplied ownership excerpt"}]}}}},"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"},"edgeCount":{"type":"number"},"chainCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"parent":{"type":"string"},"child":{"type":"string"},"percent":{"type":"number"},"percentSupplied":{"type":"boolean"},"asOf":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"mapped","edgeCount":2,"chainCount":3,"items":[{"parent":"Ultimate Parent SA","child":"HoldCo Ltd","percent":75,"percentSupplied":true,"asOf":"2026-01-01","source":"Caller-supplied ownership excerpt","sourceUrl":"","path":["Ultimate Parent SA","HoldCo Ltd"]},{"parent":"HoldCo Ltd","child":"Example Construction LLC","percent":100,"percentSupplied":true,"asOf":"2026-01-01","source":"Caller-supplied ownership excerpt","sourceUrl":"","path":["Ultimate Parent SA","HoldCo Ltd","Example Construction LLC"]},{"path":["Ultimate Parent SA","HoldCo Ltd","Example Construction LLC"],"depth":2}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/name-variant-resolve":{"post":{"operationId":"resolve_corporate_name_variants","summary":"Resolve corporate name variants","description":"Group legal, trading, and alias names per company. Similar-only variants stay possible and are not confirmed identity matches.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC","tradingName":"Example Construction"}],"nameVariants":[{"id":"VAR-1","companyId":"CO-1","name":"Example Construction Limited","kind":"alias","source":"Caller-supplied"},{"id":"VAR-2","companyId":"CO-1","name":"Ex Construct Co","kind":"alias","source":"Caller-supplied"}]}}}},"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"},"companyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"string"},"canonicalName":{"type":"string"},"canonicalNormalized":{"type":"string"},"variantCount":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"normalizedName":{"type":"string"},"kind":{"type":"string"},"source":{"type":"string"},"matchKind":{"type":"string"},"score":{"type":"number"},"confirmedSameIdentity":{"type":"boolean"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"resolved","companyCount":1,"items":[{"companyId":"CO-1","canonicalName":"Example Construction LLC","canonicalNormalized":"example construction","variantCount":4,"variants":[{"name":"Example Construction LLC","normalizedName":"example construction","kind":"legal","source":"","matchKind":"exact","score":1,"confirmedSameIdentity":true,"uncertainMatchTreatedAsConfirmed":false},{"name":"Example Construction","normalizedName":"example construction","kind":"trading","source":"","matchKind":"exact","score":1,"confirmedSameIdentity":true,"uncertainMatchTreatedAsConfirmed":false},{"name":"Example Construction Limited","normalizedName":"example construction","kind":"alias","source":"Caller-supplied","matchKind":"exact","score":1,"confirmedSameIdentity":true,"uncertainMatchTreatedAsConfirmed":false},{"name":"Ex Construct Co","normalizedName":"ex construct","kind":"alias","source":"Caller-supplied","matchKind":"none","score":0,"confirmedSameIdentity":false,"uncertainMatchTreatedAsConfirmed":false}],"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/sanctions-list-change-detect":{"post":{"operationId":"detect_sanctions_list_changes","summary":"Detect sanctions list changes","description":"Diff current and previous supplied sanctions entries by normalized name. Optional OFAC fetch can populate the current list when requested.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"previousSanctionsEntries":[{"id":"SAN-1","list":"OFAC SDN excerpt","name":"Blocked Entity One","program":"SDN","source":"Caller-supplied snapshot","sourceUrl":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"},{"id":"SAN-2","list":"OFAC SDN excerpt","name":"Removed Entity","program":"SDN","source":"Caller-supplied snapshot"}],"sanctionsEntries":[{"id":"SAN-1","list":"OFAC SDN excerpt","name":"Blocked Entity One","program":"SDN","source":"Caller-supplied snapshot","sourceUrl":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"},{"id":"SAN-3","list":"OFAC SDN excerpt","name":"Newly Listed Entity","program":"SDN","source":"Caller-supplied snapshot"}]}}}},"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"},"addedCount":{"type":"number"},"removedCount":{"type":"number"},"unchangedCount":{"type":"number"},"added":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"list":{"type":"string"},"name":{"type":"string"},"normalizedName":{"type":"string"},"program":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"removed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"list":{"type":"string"},"name":{"type":"string"},"normalizedName":{"type":"string"},"program":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"compared","addedCount":1,"removedCount":1,"unchangedCount":1,"added":[{"id":"SAN-3","list":"OFAC SDN excerpt","name":"Newly Listed Entity","normalizedName":"newly listed entity","program":"SDN","source":"Caller-supplied snapshot","sourceUrl":""}],"removed":[{"id":"SAN-2","list":"OFAC SDN excerpt","name":"Removed Entity","normalizedName":"removed entity","program":"SDN","source":"Caller-supplied snapshot","sourceUrl":""}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/company-enforcement-history":{"post":{"operationId":"list_company_enforcement_history","summary":"List company enforcement history","description":"Attach supplied enforcement actions to companies. Possible name matches are listed separately and never confirmed.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC"}],"enforcementRecords":[{"id":"ENF-1","companyId":"CO-1","companyName":"Example Construction LLC","authority":"OSHA excerpt","action":"citation","date":"2025-04-01","reference":"OSHA-1","summary":"Caller-supplied enforcement excerpt","source":"Caller-supplied","sourceUrl":"https://example.invalid/enforcement/OSHA-1"},{"id":"ENF-2","companyName":"Example Constructing","authority":"EPA excerpt","action":"notice","date":"2024-11-02","source":"Caller-supplied"}]}}}},"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"},"companyCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"confirmedCount":{"type":"number"},"possibleCount":{"type":"number"},"confirmedRecords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authority":{"type":"string"},"action":{"type":"string"},"date":{"type":"string"},"reference":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"matchKind":{"type":"string"},"confirmedEnforcementMatch":{"type":"boolean"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"}},"additionalProperties":true}},"possibleRecords":{"type":"array","items":{}},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"listed","companyCount":1,"items":[{"companyId":"CO-1","companyName":"Example Construction LLC","confirmedCount":1,"possibleCount":0,"confirmedRecords":[{"id":"ENF-1","authority":"OSHA excerpt","action":"citation","date":"2025-04-01","reference":"OSHA-1","summary":"Caller-supplied enforcement excerpt","source":"Caller-supplied","sourceUrl":"https://example.invalid/enforcement/OSHA-1","matchKind":"exact","confirmedEnforcementMatch":true,"uncertainMatchTreatedAsConfirmed":false}],"possibleRecords":[],"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":true}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/public-procurement-exclusion-check":{"post":{"operationId":"check_public_procurement_exclusions","summary":"Check public procurement exclusions","description":"Compare companies to a supplied procurement exclusion list. Only exact name or registry matches are confirmed exclusions.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC","registryNumber":"12345678"},{"id":"CO-2","legalName":"Clean Vendor Inc","registryNumber":"999"}],"exclusions":[{"id":"EXC-1","companyName":"Example Construction LLC","registryNumber":"12345678","authority":"Caller-supplied debarment excerpt","reason":"debarred","effectiveOn":"2025-01-01","source":"Caller-supplied"},{"id":"EXC-2","companyName":"Example Constructing Co","authority":"Caller-supplied debarment excerpt","reason":"suspended","effectiveOn":"2025-06-01","source":"Caller-supplied"}]}}}},"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"},"companyCount":{"type":"number"},"confirmedExcludedCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"confirmedCount":{"type":"number"},"possibleCount":{"type":"number"},"excludedConfirmed":{"type":"boolean"},"confirmedMatches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authority":{"type":"string"},"reason":{"type":"string"},"effectiveOn":{"type":"string"},"expiresOn":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"matchKind":{"type":"string"},"confirmedExclusionMatch":{"type":"boolean"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"}},"additionalProperties":true}},"possibleMatches":{"type":"array","items":{}},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedSanctionsMatch":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"checked","companyCount":2,"confirmedExcludedCount":1,"items":[{"companyId":"CO-1","companyName":"Example Construction LLC","confirmedCount":1,"possibleCount":0,"excludedConfirmed":true,"confirmedMatches":[{"id":"EXC-1","authority":"Caller-supplied debarment excerpt","reason":"debarred","effectiveOn":"2025-01-01","expiresOn":"","source":"Caller-supplied","sourceUrl":"","matchKind":"exact","confirmedExclusionMatch":true,"uncertainMatchTreatedAsConfirmed":false}],"possibleMatches":[],"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false},{"companyId":"CO-2","companyName":"Clean Vendor Inc","confirmedCount":0,"possibleCount":0,"excludedConfirmed":false,"confirmedMatches":[],"possibleMatches":[],"uncertainMatchTreatedAsConfirmed":false,"confirmedSanctionsMatch":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/network-relationship-analyze":{"post":{"operationId":"analyze_corporate_network_relationships","summary":"Analyze corporate network relationships","description":"Build a relationship graph from supplied directors, ownership edges, and explicit relationships.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"directors":[{"id":"DIR-1","companyId":"CO-1","companyName":"Example Construction LLC","name":"Ada Example","role":"director"}],"ownership":[{"id":"OWN-1","parentName":"HoldCo Ltd","childName":"Example Construction LLC","percent":100}],"relationships":[{"id":"REL-1","fromName":"Ada Example","toName":"HoldCo Ltd","kind":"director","source":"Caller-supplied"}]}}}},"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"},"nodeCount":{"type":"number"},"edgeCount":{"type":"number"},"nodes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"degree":{"type":"number"}},"additionalProperties":true}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"kind":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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","nodeCount":3,"edgeCount":3,"nodes":[{"name":"Ada Example","degree":2},{"name":"HoldCo Ltd","degree":2},{"name":"Example Construction LLC","degree":2}],"edges":[{"id":"REL-1","from":"Ada Example","to":"HoldCo Ltd","kind":"director","source":"Caller-supplied","sourceUrl":""},{"id":"OWN-1","from":"HoldCo Ltd","to":"Example Construction LLC","kind":"ownership","source":"","sourceUrl":""},{"id":"DIR-1","from":"Ada Example","to":"Example Construction LLC","kind":"director","source":"","sourceUrl":""}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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/corporate-intelligence/investigation-source-citation-package":{"post":{"operationId":"build_investigation_source_citation_package","summary":"Build investigation source citation package","description":"Aggregate registry, ownership, sanctions, enforcement, exclusion, and network summaries with source citations. Uncertain matches stay unconfirmed.","tags":["corporate-intelligence"],"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},"companies":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"legalName":{"type":"string","maxLength":300},"tradingName":{"type":"string","maxLength":300},"registry":{"type":"string","maxLength":120},"registryNumber":{"type":"string","maxLength":80},"lei":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"address":{"type":"string","maxLength":400},"incorporatedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"directors":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"name":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":120},"appointedOn":{"type":"string","maxLength":40},"resignedOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"ownership":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"parentId":{"type":"string","maxLength":80},"parentName":{"type":"string","maxLength":300},"childId":{"type":"string","maxLength":80},"childName":{"type":"string","maxLength":300},"percent":{"type":"number","minimum":0,"maximum":100},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"nameVariants":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"sanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"previousSanctionsEntries":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"list":{"type":"string","maxLength":120},"name":{"type":"string","maxLength":300},"aliases":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":300}},"program":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"listedOn":{"type":"string","maxLength":40},"snapshot":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"enforcementRecords":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyId":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"authority":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"summary":{"type":"string","maxLength":500},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"exclusions":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"companyName":{"type":"string","maxLength":300},"registryNumber":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"reason":{"type":"string","maxLength":400},"effectiveOn":{"type":"string","maxLength":40},"expiresOn":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"relationships":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"fromId":{"type":"string","maxLength":80},"fromName":{"type":"string","maxLength":300},"toId":{"type":"string","maxLength":80},"toName":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false}},"asOf":{"type":"string","maxLength":40},"fetchOfac":{"type":"boolean"}},"additionalProperties":false},"example":{"companies":[{"id":"CO-1","legalName":"Example Construction LLC","registryNumber":"12345678","source":"Caller-supplied registry","sourceUrl":"https://example.invalid/registry/12345678"}],"directors":[{"id":"DIR-1","companyId":"CO-1","companyName":"Example Construction LLC","name":"Ada Example","role":"director","appointedOn":"2020-01-15","source":"Caller-supplied filing"}],"ownership":[{"id":"OWN-1","parentName":"HoldCo Ltd","childId":"CO-1","childName":"Example Construction LLC","percent":100,"source":"Caller-supplied"}],"sanctionsEntries":[{"id":"SAN-1","list":"OFAC SDN excerpt","name":"Unrelated Blocked Party","program":"SDN","source":"Caller-supplied","sourceUrl":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"}],"enforcementRecords":[{"id":"ENF-1","companyId":"CO-1","companyName":"Example Construction LLC","authority":"OSHA excerpt","action":"citation","date":"2025-04-01","source":"Caller-supplied"}],"exclusions":[{"id":"EXC-1","companyName":"Other Debarred Co","authority":"Caller-supplied","reason":"debarred","effectiveOn":"2025-01-01","source":"Caller-supplied"}],"relationships":[{"id":"REL-1","fromName":"Ada Example","toName":"Example Construction LLC","kind":"director","source":"Caller-supplied"}]}}}},"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"},"companyCount":{"type":"number"},"citationCount":{"type":"number"},"sections":{"type":"object","properties":{"registry":{"type":"object","properties":{"companyCount":{"type":"number"}},"additionalProperties":true},"identity":{"type":"object","properties":{"pairCount":{"type":"number"}},"additionalProperties":true},"directors":{"type":"object","properties":{"companyCount":{"type":"number"}},"additionalProperties":true},"ownership":{"type":"object","properties":{"chainCount":{"type":"number"}},"additionalProperties":true},"nameVariants":{"type":"object","properties":{"companyCount":{"type":"number"}},"additionalProperties":true},"sanctionsChanges":{"type":"object","properties":{"addedCount":{"type":"number"},"removedCount":{"type":"number"}},"additionalProperties":true},"enforcement":{"type":"object","properties":{"companyCount":{"type":"number"}},"additionalProperties":true},"exclusions":{"type":"object","properties":{"confirmedExcludedCount":{"type":"number"}},"additionalProperties":true},"network":{"type":"object","properties":{"nodeCount":{"type":"number"},"edgeCount":{"type":"number"}},"additionalProperties":true},"sanctionsScreen":{"type":"object","properties":{"confirmedCount":{"type":"number"},"possibleCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"citations":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"sanctionsScreen":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"matchKind":{"type":"string"},"score":{"type":"number"},"listEntryName":{"type":"string"},"listEntryId":{"type":"string"},"list":{"type":"string"},"confirmedSanctionsMatch":{"type":"boolean"},"uncertainMatchTreatedAsConfirmed":{"type":"boolean"},"confirmedEnforcementMatch":{"type":"boolean"}},"additionalProperties":true}},"uncertainMatchTreatedAsConfirmed":{"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":"packaged","companyCount":1,"citationCount":7,"sections":{"registry":{"companyCount":1},"identity":{"pairCount":0},"directors":{"companyCount":1},"ownership":{"chainCount":2},"nameVariants":{"companyCount":1},"sanctionsChanges":{"addedCount":1,"removedCount":0},"enforcement":{"companyCount":1},"exclusions":{"confirmedExcludedCount":0},"network":{"nodeCount":3,"edgeCount":3},"sanctionsScreen":{"confirmedCount":0,"possibleCount":0}},"citations":[{"kind":"company","id":"CO-1","source":"Caller-supplied registry","sourceUrl":"https://example.invalid/registry/12345678"},{"kind":"director","id":"DIR-1","source":"Caller-supplied filing","sourceUrl":""},{"kind":"ownership","id":"OWN-1","source":"Caller-supplied","sourceUrl":""},{"kind":"sanctions","id":"SAN-1","source":"Caller-supplied","sourceUrl":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"},{"kind":"enforcement","id":"ENF-1","source":"Caller-supplied","sourceUrl":""},{"kind":"exclusion","id":"EXC-1","source":"Caller-supplied","sourceUrl":""},{"kind":"relationship","id":"REL-1","source":"Caller-supplied","sourceUrl":""}],"sanctionsScreen":[{"companyId":"CO-1","companyName":"Example Construction LLC","matchKind":"none","score":0,"listEntryName":"","listEntryId":"","list":"","confirmedSanctionsMatch":false,"uncertainMatchTreatedAsConfirmed":false,"confirmedEnforcementMatch":false}],"uncertainMatchTreatedAsConfirmed":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"missing","code":"companies","subject":"","detail":"At least two company records are needed for cross-check."},{"kind":"missing","code":"previous_sanctions","subject":"","detail":"Previous sanctions snapshot was not supplied."}],"limitations":["Company, director, ownership, sanctions, enforcement, and exclusion records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid corporate-data provider is used and no API key is required.","Uncertain name matches are labeled possible only and are never treated as confirmed sanctions or enforcement matches.","Confirmed sanctions or enforcement flags require an exact normalized-name or registry-number match against a supplied or fetched list entry.","Ownership chains and network graphs use only supplied edges. Missing percentages and links are not invented."]}}}},"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":{}}}}}}}}