Factor Taxonomy

GET/v1/risk/factors$0.01 per call

Returns the complete factor taxonomy — all 70+ scored factors for both business and individual assessments, industry weight profiles, and score band definitions.

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.business	object
data.business.factorCount	number	e.g. `74`
data.business.factors	array
data.individual	object
data.individual.factorCount	number	e.g. `45`
data.individual.factors	array
data.industries	array
data.industries[].name	string	e.g. `Financial Services`
data.industries[].keywords	array
data.industries[].adjustedFactorCount	number	e.g. `11`
data.scoreBands	array
data.scoreBands[].band	string	e.g. `LOW`
data.scoreBands[].range	string	e.g. `0–200`
data.scoreBands[].meaning	string	e.g. `Minimal identified risk`
meta	object
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

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 "https://api.compliancegrid.ai/v1/risk/factors" \
  -H "Authorization: Bearer $CG_API_KEY"

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

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

{
  "success": true,
  "data": {
    "business": {
      "factorCount": 74,
      "factors": [
        {
          "code": "BIZ_OFAC_SDN_DIRECT",
          "name": "Direct OFAC SDN match (entity or related officer)",
          "category": "SANCTIONS_WATCHLISTS",
          "categoryName": "Sanctions & Watchlists",
          "maxPoints": 200,
          "description": "Entity or named officer appears on OFAC Specially Designated Nationals list",
          "dataSource": "OFAC SDN List via ComplianceGrid CSL",
          "industrySpecific": null
        },
        {
          "code": "BIZ_OFAC_CMIC",
          "name": "OFAC CMIC List match (Chinese Military-Industrial Complex)",
          "category": "SANCTIONS_WATCHLISTS",
          "categoryName": "Sanctions & Watchlists",
          "maxPoints": 160,
          "description": "Entity appears on OFAC Non-SDN Chinese Military-Industrial Complex Companies List — investment prohibition on publicly traded securities",
          "dataSource": "OFAC CMIC List via ComplianceGrid CSL",
          "industrySpecific": null
        }
      ]
    },
    "individual": {
      "factorCount": 45,
      "factors": [
        {
          "code": "IND_OFAC_SDN_DIRECT",
          "name": "Direct OFAC SDN individual match",
          "category": "SANCTIONS_WATCHLISTS",
          "categoryName": "Sanctions & Watchlists",
          "maxPoints": 200,
          "description": "Individual appears on OFAC Specially Designated Nationals list",
          "dataSource": "OFAC SDN List via ComplianceGrid CSL",
          "industrySpecific": null
        },
        {
          "code": "IND_OFAC_SDN_OFFICER",
          "name": "OFAC SDN match as officer/director of sanctioned entity",
          "category": "SANCTIONS_WATCHLISTS",
          "categoryName": "Sanctions & Watchlists",
          "maxPoints": 160,
          "description": "Individual is officer/director of an OFAC-designated entity",
          "dataSource": "OFAC SDN + corporate records",
          "industrySpecific": null
        }
      ]
    },
    "industries": [
      {
        "name": "Financial Services",
        "keywords": [
          "financial",
          "banking"
        ],
        "adjustedFactorCount": 11
      },
      {
        "name": "Healthcare & Pharma",
        "keywords": [
          "healthcare",
          "pharma"
        ],
        "adjustedFactorCount": 5
      }
    ],
    "scoreBands": [
      {
        "band": "LOW",
        "range": "0–200",
        "meaning": "Minimal identified risk"
      },
      {
        "band": "MEDIUM",
        "range": "201–400",
        "meaning": "Some risk factors identified — standard due diligence recommended"
      }
    ]
  },
  "meta": {
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}