Exclusion Screen API Documentation

Normalize a vendor name and screen it against OFAC SDN and UK Sanctions List with timestamped evidence, batch screening, and multi-list screening. Payment is the exact USDC price on Base with x402.

POSThttps://brainiac.software/api/v1/exclusion/normalize$0.01 USDC

Normalize a vendor identity

Normalize identifiers before source screening. This operation does not determine eligibility.

Body

FieldRequiredNotes
legalNameYesstring

Request exampleJSON

{
  "legalName": "Example Construction LLC",
  "country": "USA"
}

Response exampleJSON

{
  "legalName": "Example Construction LLC",
  "normalizedName": "example construction",
  "warnings": []
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/normalize" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "legalName": "Example Construction LLC",
  "country": "USA"
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/screen$0.15 USDC

Screen a vendor against OFAC

Compare a vendor name with the official OFAC SDN list. Candidate matches require human review; source unavailability produces WARN.

Body

FieldRequiredNotes
legalNameYesstring

Request exampleJSON

{
  "legalName": "Example Construction LLC",
  "country": "USA"
}

Response exampleJSON

{
  "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"
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/screen" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "legalName": "Example Construction LLC",
  "country": "USA"
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/evidence-report$0.15 USDC

Build an exclusion screening evidence report

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.

Body

FieldRequiredNotes
legalNameYesstring

Request exampleJSON

{
  "legalName": "Example Construction LLC",
  "country": "USA"
}

Response exampleJSON

{
  "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."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/evidence-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "legalName": "Example Construction LLC",
  "country": "USA"
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/uk/screen$0.15 USDC

Screen a vendor against UK Sanctions List

Compare a vendor name with the official UK Sanctions List XML. Candidate matches require human review; source unavailability produces WARN.

Body

FieldRequiredNotes
legalNameYesstring

Request exampleJSON

{
  "legalName": "Example Construction LLC",
  "country": "GBR"
}

Response exampleJSON

{
  "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."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/uk/screen" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "legalName": "Example Construction LLC",
  "country": "GBR"
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/uk/changes$0.05 USDC

Get UK Sanctions List changes

Retrieve changes to the UK Sanctions List since a given date, using the official Last Updated field and designation dates.

Body

FieldRequiredNotes
sinceNostring

Request exampleJSON

{
  "since": "2026-01-01"
}

Response exampleJSON

{
  "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."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/uk/changes" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "since": "2026-01-01"
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/batch-screen$0.10 USDC

Batch screen vendors against OFAC

Screen multiple vendors against the official OFAC SDN list. Each vendor is screened independently.

Body

FieldRequiredNotes
vendorsYesarray; Array

Request exampleJSON

{
  "vendors": [
    {
      "legalName": "Example Construction LLC"
    },
    {
      "legalName": "Another Company LLC"
    }
  ]
}

Response exampleJSON

{
  "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."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/batch-screen" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "vendors": [
    {
      "legalName": "Example Construction LLC"
    },
    {
      "legalName": "Another Company LLC"
    }
  ]
}
JSON
POSThttps://brainiac.software/api/v1/exclusion/multi-list/screen$0.20 USDC

Screen a vendor against multiple exclusion lists

Combine OFAC SDN and UK Sanctions List screening for a single vendor. Matches across lists require human identity review.

Body

FieldRequiredNotes
legalNameYesstring

Request exampleJSON

{
  "legalName": "Example Construction LLC",
  "country": "USA"
}

Response exampleJSON

{
  "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."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/exclusion/multi-list/screen" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "legalName": "Example Construction LLC",
  "country": "USA"
}
JSON