---
title: "List risk checks"
method: GET
path: "/api/v2/numbers/risk_checks"
tags: ["Risk Checks"]
---

# List risk checks

`GET /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

Retrieves a list of risk check tasks.

Returns information about all risk check tasks created by your organization,
including task status, number counts, and processing timestamps. Supports filtering by various criteria and pagination.

`tasks[].id` feeds numbers_risk_checks_logs (`task_ids`). Rows: numbers_risk_checks_logs.

## Query parameters

- `task_ids` string
- `status` 'pending' | 'completed' | 'failed'
- `created_at_from` string, date
- `created_at_to` string, date
- `processed_at_from` string, date
- `processed_at_to` string, date
- `order_by` string
- `order` 'asc' | 'desc'
- `page` integer
- `per_page` integer

## Response `200`

returns risk check tasks

- object
  - `tasks` object[], required: List of risk check tasks
    - `id` integer, required: Task identifier
    - `status` 'pending' | 'completed' | 'failed', required: Task status
    - `processed_at` string, required: Processing completion timestamp
    - `created_at` string, required: Task creation timestamp
    - `total_numbers` integer, required: Total numbers in the task
    - `completed_count` integer, required: Number of completed checks
    - `failed_count` integer, required: Number of failed checks
    - `pending_count` integer, required: Number of pending checks
  - `pagination` object, required: Pagination metadata
    - `total` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages
    - `current_page` integer, required: Current page number
    - `per_page` integer, required: Items per page

## Other responses

- `401`: returns unauthorized for without authentication
- `403`: returns forbidden for without access to risk checks

---

[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)