Create a risk rating

POST

/verification/{verification_signature_key}/risk-ratings/

Create a new risk rating for a verification.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

Existing pending risk rating returned

Bodyapplication/json

🟢201

🟠400

🟠403Forbidden

🔴500UnknownError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/verification//risk-ratings/' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "callback_url": "https://realaml.com"
}'

Response Example

200 - Example 1

{
    "id": "3a2c6531-2085-46fa-b47f-8744d3abaa73",
    "created_at": "2026-02-03T01:51:38.615784Z",
    "completed_by_name": "string",
    "completed_by_email": "user@example.com",
    "completed_at": "2019-08-24T14:15:22.123Z",
    "started_at": "2019-08-24T14:15:22.123Z",
    "risk_score": 0,
    "risk_level": "PENDING",
    "risk_level_override_notes": "string",
    "risk_assessment_notes": [
        "string"
    ],
    "risk_assessment_answers": [
        {
            "id": "string",
            "created_at": "2019-08-24T14:15:22.123Z",
            "risk_answer_max_score": 0,
            "comment": "string",
            "risk_question": {
                "id": "string",
                "question": "string",
                "risk_section": {
                    "name": "string"
                }
            },
            "risk_answers": [
                {
                    "id": "string",
                    "answer": "string",
                    "score": 0,
                    "high_risk": true
                }
            ]
        }
    ],
    "risk_profile_id": "string",
    "system_generated_profile": true,
    "report": {
        "property1": "string",
        "property2": "string"
    },
    "url": "http://example.com"
}

Delete an outsourced verification

Get risk rating details