{"openapi":"3.1.0","info":{"title":"OFAC & UK Sanctions Screening API","version":"1.0.0","description":"Normalize a vendor name and screen it against OFAC SDN and UK Sanctions List with timestamped evidence, batch screening, and multi-list screening. 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/exclusion/normalize":{"post":{"operationId":"normalize_a_vendor_identity","summary":"Normalize a vendor identity","description":"Normalize identifiers before source screening. This operation does not determine eligibility.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false},"example":{"legalName":"Example Construction LLC"}}}},"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":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"warnings":{"type":"array","items":{}}},"additionalProperties":true},"example":{"legalName":"Example Construction LLC","normalizedName":"example construction","warnings":[]}}}},"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.01"},"protocols":[{"x402":{}}]}}},"/api/v1/exclusion/screen":{"post":{"operationId":"screen_a_vendor_against_ofac","summary":"Screen a vendor against OFAC","description":"Compare a vendor name with the official OFAC SDN list. Candidate matches require human review; source unavailability produces WARN.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false},"example":{"legalName":"Example Construction LLC"}}}},"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":{"checkId":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"warnings":{"type":"array","items":{}}},"additionalProperties":true},"status":{"type":"string"},"matches":{"type":"array","items":{}},"sources":{"type":"object","properties":{"ofac":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"snapshotHash":{"type":"string"}},"additionalProperties":true},"example":{"checkId":"0ed2a4d0-76b2-4c7f-9f2f-94d2f3e7d230","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","warnings":[]},"status":"CLEAR","matches":[],"sources":{"ofac":{"status":"CHECKED","url":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"}},"snapshotHash":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"}}}},"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.15"},"protocols":[{"x402":{}}]}}},"/api/v1/exclusion/evidence-report":{"post":{"operationId":"build_an_exclusion_screening_evidence_report","summary":"Build an exclusion screening evidence report","description":"Screen a vendor name against the official OFAC SDN list and produce a PDF with source status, candidate records, timestamp, and snapshot hash. Matches are not identity confirmations.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false},"example":{"legalName":"Example Construction LLC"}}}},"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":{"checkId":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"}},"additionalProperties":true},"status":{"type":"string"},"matches":{"type":"array","items":{}},"sources":{"type":"object","properties":{"ofac":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"snapshotHash":{"type":"string"},"checkedAt":{"type":"string"},"evidencePdfBase64":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkId":"5c12bf4e-3c45-4fdb-b7a4-d65e7e634f6a","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction"},"status":"CLEAR","matches":[],"sources":{"ofac":{"status":"CHECKED","url":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"}},"snapshotHash":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","checkedAt":"2026-10-29T12:00:00.000Z","evidencePdfBase64":"<base64-encoded-pdf>","limitations":["Name screening can produce false positives or miss aliases. This is an evidence aid, not a legal determination."]}}}},"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.15"},"protocols":[{"x402":{}}]}}},"/api/v1/exclusion/uk/screen":{"post":{"operationId":"screen_a_vendor_against_uk_sanctions_list","summary":"Screen a vendor against UK Sanctions List","description":"Compare a vendor name with the official UK Sanctions List XML. Candidate matches require human review; source unavailability produces WARN.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false},"example":{"legalName":"Example Construction LLC"}}}},"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":{"checkId":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"}},"additionalProperties":true},"status":{"type":"string"},"matches":{"type":"array","items":{}},"sources":{"type":"object","properties":{"uk":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"snapshotHash":{"type":"string"},"checkedAt":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkId":"abc123-def456-ghi789","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction"},"status":"CLEAR","matches":[],"sources":{"uk":{"status":"CHECKED","url":"https://sanctionslist.fcdo.gov.uk/docs/UK-Sanctions-List.xml"}},"snapshotHash":"9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba","checkedAt":"2026-10-29T12:00:00.000Z","limitations":["Screening checks UK Sanctions List name records only. It does not confirm identity; name matches may be false positives or miss aliases. Human review is required."]}}}},"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.15"},"protocols":[{"x402":{}}]}}},"/api/v1/exclusion/uk/changes":{"post":{"operationId":"get_uk_sanctions_list_changes","summary":"Get UK Sanctions List changes","description":"Retrieve changes to the UK Sanctions List since a given date, using the official Last Updated field and designation dates.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"since":{"type":"string"}},"additionalProperties":false},"example":{"since":"2026-01-01"}}}},"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"},"lastUpdated":{"type":"string"},"changes":{"type":"array","items":{}},"total":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-10-29T12:00:00.000Z","lastUpdated":"2026-10-28T00:00:00.000Z","changes":[],"total":0,"sources":[{"source":"UK Sanctions List","url":"https://sanctionslist.fcdo.gov.uk/docs/UK-Sanctions-List.xml","retrievedAt":"2026-10-29T12:00:00.000Z"}],"limitations":["Changes are based on designation dates.","Since filtering is applied after fetching the full list.","Last Updated field reflects the list publication date."]}}}},"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/exclusion/batch-screen":{"post":{"operationId":"batch_screen_vendors_against_ofac","summary":"Batch screen vendors against OFAC","description":"Screen multiple vendors against the official OFAC SDN list. Each vendor is screened independently.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendors":{"type":"array","items":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false}}},"required":["vendors"],"additionalProperties":false},"example":{"vendors":[{"legalName":"Example Construction LLC"},{"legalName":"Another Company LLC"}]}}}},"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"},"results":{"type":"array","items":{"type":"object","properties":{"checkId":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"}},"additionalProperties":true},"status":{"type":"string"},"matches":{"type":"array","items":{}},"sources":{"type":"object","properties":{"ofac":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"snapshotHash":{"type":"string"},"checkedAt":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"total":{"type":"number"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-10-29T12:00:00.000Z","results":[{"checkId":"abc123","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction"},"status":"CLEAR","matches":[],"sources":{"ofac":{"status":"CHECKED","url":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"}},"snapshotHash":"abc123","checkedAt":"2026-10-29T12:00:00.000Z","limitations":["Screening checks OFAC SDN name records only."]},{"checkId":"def456","vendor":{"legalName":"Another Company LLC","normalizedName":"another company"},"status":"CLEAR","matches":[],"sources":{"ofac":{"status":"CHECKED","url":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"}},"snapshotHash":"def456","checkedAt":"2026-10-29T12:00:00.000Z","limitations":["Screening checks OFAC SDN name records only."]}],"total":2,"limitations":["Batch screens each vendor independently.","OFAC list is fetched once per batch item; consider caching for large batches."]}}}},"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.10"},"protocols":[{"x402":{}}]}}},"/api/v1/exclusion/multi-list/screen":{"post":{"operationId":"screen_a_vendor_against_multiple_exclusion_lists","summary":"Screen a vendor against multiple exclusion lists","description":"Combine OFAC SDN and UK Sanctions List screening for a single vendor. Matches across lists require human identity review.","tags":["exclusion"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":240}},"required":["legalName"],"additionalProperties":false},"example":{"legalName":"Example Construction LLC"}}}},"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":{"checkId":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"}},"additionalProperties":true},"status":{"type":"string"},"matches":{"type":"array","items":{}},"sources":{"type":"object","properties":{"ofac":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true},"uk":{"type":"object","properties":{"status":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"checkedAt":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkId":"xyz789","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction"},"status":"CLEAR","matches":[],"sources":{"ofac":{"status":"CHECKED","url":"https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"},"uk":{"status":"CHECKED","url":"https://sanctionslist.fcdo.gov.uk/docs/UK-Sanctions-List.xml"}},"checkedAt":"2026-10-29T12:00:00.000Z","limitations":["Multi-list screening combines OFAC SDN and UK Sanctions List.","Each list has its own limitations and update frequency.","Matches across lists require human identity review."]}}}},"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.20"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}