Ownership Screening (OFAC 50% / BIS Affiliates Rule)

POST/v1/compliance/ownership-screening$0.05 per call

Aggregates effective ownership through the structure you supply and screens every owner against the Consolidated Screening List. Reports the OFAC 50 Percent Rule (SDN owners) and the BIS Affiliates Rule (Entity List / MEU owners, with its current effective date). Ownership data is supplied by the caller.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
entityrequired	object
entity.namerequired	string
entity.countryoptional	string	max length 3
ownersrequired	array of object	Ownership structure supplied by you (at most 50 owners in total, 5 levels deep). ComplianceGrid does not source beneficial ownership data. min 1 items · max 50 items
owners[].namerequired	string
owners[].countryoptional	string	max length 3
owners[].ownershipPercentrequired	number	Direct ownership of the parent node min 0 · max 100
owners[].ownersoptional	array of object	max 50 items
owners[].owners[].namerequired	string
owners[].owners[].countryoptional	string	max length 3
owners[].owners[].ownershipPercentrequired	number	Direct ownership of the parent node min 0 · max 100
owners[].owners[].ownersoptional	array of object	max 50 items
owners[].owners[].owners[].namerequired	string
owners[].owners[].owners[].countryoptional	string	max length 3
owners[].owners[].owners[].ownershipPercentrequired	number	Direct ownership of the parent node min 0 · max 100
owners[].owners[].owners[].ownersoptional	array of object	max 50 items

Response fields

Field	Type	Description
success	boolean
data	object
meta	object
meta.dataSource	object
meta.dataSource.name	string	Name of the source that produced this response
meta.dataSource.provenance	string	live = fetched from the upstream source for this request; database = synced copy; curated = small hand-maintained dataset (absence of a hit is not a clean result); computed = produced by ComplianceGrid rules; seed = development placeholder data; mock = sandbox canned response
meta.dataSource.note	string

Fields are read from a real response captured 2026-11-04, shortened. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl -X POST "https://api.compliancegrid.ai/v1/compliance/ownership-screening" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": {
      "name": "Acme Widgets Ltd"
    },
    "owners": [
      {
        "name": "Acme Widgets Ltd",
        "ownershipPercent": 0
      }
    ]
  }'

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

Request body (JSON)

Example response · captured from production 2026-11-04 · shortened

{
  "success": true,
  "data": {
    "id": "own_09ec282d32d959e4",
    "screeningDate": "2026-11-04T09:01:08.366Z",
    "entity": {
      "name": "Acme Widgets Ltd",
      "screening": {
        "result": "CLEAR",
        "strongMatches": []
      }
    },
    "ownershipGraph": [
      {
        "name": "Acme Widgets Ltd",
        "effectiveOwnershipPercent": 0,
        "depth": 1,
        "paths": [
          "Acme Widgets Ltd > Acme Widgets Ltd"
        ],
        "screening": {
          "result": "CLEAR",
          "strongMatches": [],
          "weakMatchCount": 0
        }
      }
    ],
    "ofac50PercentRule": {
      "rule": "OFAC 50 Percent Rule: an entity owned 50% or more, directly or indirectly and in the aggregate, by one or more blocked persons is itself blocked",
      "thresholdPercent": 50,
      "blockedOwnershipPercent": 0,
      "blockedOwners": [],
      "entityDirectlyListed": false,
      "treatedAsBlocked": false,
      "note": "OFAC also advises caution where blocked persons hold less than 50% but control the entity; ownership percentage alone does not capture control."
    },
    "bisAffiliatesRule": {
      "name": "BIS Affiliates Rule (50% rule for Entity List and Military End-User List parties)",
      "resumesOn": "2026-11-10",
      "inEffect": false,
      "note": "BIS suspended this rule; the date shown is when the suspension is scheduled to end. Extensions have been discussed, so confirm the current status with BIS or counsel before relying on it.",
      "thresholdPercent": 50,
      "listedOwnershipPercent": 0,
      "listedOwners": [],
      "exposed": false,
      "enforceable": false
    },
    "overallResult": "NO_EXPOSURE_IDENTIFIED",
    "warnings": [],
    "dataLimitations": [
      "The ownership structure is supplied by the caller. ComplianceGrid does not source beneficial ownership data, so the result is only as complete as the structure you provide.",
      "Owners are matched to lists by name. A POTENTIAL_MATCH needs analyst review against identifiers (address, date of birth, registration numbers) before it is treated as a blocked person."
    ],
    "listVersion": "58f4d6155f88d413",
    "listRetrievedAt": "2026-11-03T10:30:35.601Z",
    "listSource": "trade.gov Consolidated Screening List (database sync)",
    "screeningId": "cmw1w07f200lj2lrcu37g00zf"
  },
  "meta": {
    "requestId": "own_09ec282d32d959e4",
    "timestamp": "2026-11-04T09:01:08.366Z",
    "processingTimeMs": 217,
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}