<!-- ZenPays documentation · https://docs.zenpayz.com/docs/reference/objects/customer-risk-profile -->

# The CustomerRiskProfile object

Risk assessment profile for a customer. Contains detailed risk scoring information used for fraud prevention and compliance decisions.

## Fields

<ParamTable
  label="Field"
  rows={[
    { name: "customerId", type: "string", required: true, desc: "Customer ID this profile belongs to" },
    { name: "riskLevel", type: "RiskLevel", required: true, desc: "Overall risk level [RiskLevel](/docs/reference/enums/compliance)" },
    { name: "riskScore", type: "number", required: true, desc: "Numeric risk score (0-100, higher is riskier)" },
    { name: "factors", type: "{\n    /** Name of the risk factor */\n    name: string\n    /** Score contribution from this factor */\n    score: number\n    /** Human-readable description of the factor */\n    description: string\n  }[]", required: true, desc: "Individual risk factors contributing to the score" },
    { name: "lastAssessedAt", type: "string", required: true, desc: "ISO 8601 timestamp when the risk was last assessed" },
    { name: "recommendations", type: "string[]", required: false, desc: "Recommended actions based on the risk assessment" },
  ]}
/>

## Example

```json
{
  "customerId": "customer_1a2b3c",
  "riskLevel": "low",
  "riskScore": 1,
  "factors": {},
  "lastAssessedAt": "2026-01-15T09:30:00Z",
  "recommendations": []
}
```