---
title: "Create risk check"
method: POST
path: "/api/v2/numbers/risk_checks"
tags: ["Risk Checks"]
---

# Create risk check

`POST /api/v2/numbers/risk_checks`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v2/numbers/risk_checks`
- Auth: HTTP bearer

Creates a new risk check task for the provided phone numbers (maximum 1500 numbers per request).

`risk_check_request.task_id` feeds numbers_risk_checks_index and numbers_risk_checks_logs (`task_ids`):
the task status and the per-number results.

**Note:** Results are informational only. Use at your own discretion.

## Request body

- object
  - `numbers` string[]: Array of phone numbers to check for risk

## Response `201`

returns created risk check task

- object
  - `risk_check_request` object, required: Created risk check task details
    - `status` 'pending' | 'completed' | 'failed', required: Task status
    - `processed_at` unknown, required
    - `created_at` string, required: Task creation timestamp
    - `task_id` integer, required: Task identifier
    - `total_numbers` integer, required: Total numbers in the request

## Other responses

- `401`: returns unauthorized for without authentication
- `403`: returns forbidden for without access to risk checks
- `422`: returns unprocessable entity when another risk check is already running

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)