Corporate Ownership, Sanctions & Investigation API Documentation

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/registry-record-normalize$0.04 USDC

Normalize corporate registry records

Normalize supplied company registry fields and legal-name tokens. Missing identifiers stay blank rather than invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/registry-record-normalize" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/company-identity-cross-check$0.05 USDC

Cross-check company identity

Compare supplied company records by registry number, LEI, and normalized names. Possible matches are never treated as confirmed.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/company-identity-cross-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/director-history$0.04 USDC

List corporate director history

Group supplied director appointments by company into a chronological history without inventing missing dates.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/director-history" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/company-ownership-chain-map$0.05 USDC

Map company ownership chains

Walk supplied parent-child ownership edges into chains. Missing ownership percents are labeled, not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/company-ownership-chain-map" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/name-variant-resolve$0.04 USDC

Resolve corporate name variants

Group legal, trading, and alias names per company. Similar-only variants stay possible and are not confirmed identity matches.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/name-variant-resolve" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/sanctions-list-change-detect$0.05 USDC

Detect sanctions list changes

Diff current and previous supplied sanctions entries by normalized name. Optional OFAC fetch can populate the current list when requested.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/sanctions-list-change-detect" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/company-enforcement-history$0.05 USDC

List company enforcement history

Attach supplied enforcement actions to companies. Possible name matches are listed separately and never confirmed.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/company-enforcement-history" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/public-procurement-exclusion-check$0.04 USDC

Check public procurement exclusions

Compare companies to a supplied procurement exclusion list. Only exact name or registry matches are confirmed exclusions.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/public-procurement-exclusion-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/network-relationship-analyze$0.05 USDC

Analyze corporate network relationships

Build a relationship graph from supplied directors, ownership edges, and explicit relationships.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/network-relationship-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/corporate-intelligence/investigation-source-citation-package$0.08 USDC

Build investigation source citation package

Aggregate registry, ownership, sanctions, enforcement, exclusion, and network summaries with source citations. Uncertain matches stay unconfirmed.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`companies`	No	array; Array
`directors`	No	array; Array
`ownership`	No	array; Array
`nameVariants`	No	array; Array
`sanctionsEntries`	No	array; Array
`previousSanctionsEntries`	No	array; Array
`enforcementRecords`	No	array; Array
`exclusions`	No	array; Array
`relationships`	No	array; Array
`asOf`	No	string
`fetchOfac`	No	boolean

Request exampleJSON

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

Response exampleJSON

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

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/corporate-intelligence/investigation-source-citation-package" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "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"
    }
  ]
}
JSON