The Risk Checks API from DID Logic — 2 operation(s) for risk checks.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/didlogic-com:didlogic-com-risk-checks-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Didlogic Com Risk Checks API
version: 1.0.0
description: 'Operations tagged Risk Checks across 2 of this provider''s published API definitions: didlogic-com-public-api-openapi.yaml, didlogic-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.didlogic.com
description: Production
tags:
- name: Risk Checks
x-version: v2
paths:
/api/v2/numbers/risk_checks:
get:
summary: List risk checks
description: '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.'
tags:
- Risk Checks
operationId: numbers_risk_checks_index
security:
- BearerAuth: []
parameters:
- name: task_ids
in: query
required: false
schema:
type: string
example: 111,112
description: Task IDs (comma-separated) from numbers_risk_checks_create, numbers_risk_checks_logs
- name: status
in: query
required: false
schema:
type: string
enum:
- pending
- completed
- failed
example: completed,pending,failed
description: Filter by status
- name: created_at_from
in: query
required: false
schema:
type: string
format: date
example: '2026-11-02'
description: Filter created from this date (YYYY-MM-DD)
- name: created_at_to
in: query
required: false
schema:
type: string
format: date
example: '2026-11-04'
description: Filter created until this date (YYYY-MM-DD)
- name: processed_at_from
in: query
required: false
schema:
type: string
format: date
example: '2026-11-02'
description: Filter processed from this date (YYYY-MM-DD)
- name: processed_at_to
in: query
required: false
schema:
type: string
format: date
example: '2026-11-04'
description: Filter processed until this date (YYYY-MM-DD)
- name: order_by
in: query
required: false
schema:
type: string
example: created_at
description: Field to sort by
- name: order
in: query
required: false
schema:
type: string
enum:
- asc
- desc
default: desc
example: desc
description: Sort order
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
example: 1
description: Page number for pagination (starts from 1)
- name: per_page
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 20
example: 10
description: Number of items per page
responses:
'200':
description: returns risk check tasks
content:
application/json:
schema:
type: object
properties:
tasks:
type: array
items:
type: object
properties:
id:
type: integer
example: 104
description: Task identifier
status:
type: string
enum:
- pending
- completed
- failed
example: pending
description: Task status
processed_at:
type: string
example: '2026-11-03T09:53:24Z'
description: Processing completion timestamp
created_at:
type: string
example: '2026-11-03T09:53:24Z'
description: Task creation timestamp
total_numbers:
type: integer
example: 1
description: Total numbers in the task
completed_count:
type: integer
example: 0
description: Number of completed checks
failed_count:
type: integer
example: 0
description: Number of failed checks
pending_count:
type: integer
example: 1
description: Number of pending checks
required:
- id
- status
- processed_at
- created_at
- total_numbers
- completed_count
- failed_count
- pending_count
description: List of risk check tasks
pagination:
type: object
properties:
total:
type: integer
example: 2
description: Total number of items
total_pages:
type: integer
example: 1
description: Total number of pages
current_page:
type: integer
example: 1
description: Current page number
per_page:
type: integer
example: 10
description: Items per page
required:
- total
- total_pages
- current_page
- per_page
description: Pagination metadata
required:
- tasks
- pagination
example:
tasks:
- id: 104
status: pending
processed_at: '2026-11-03T09:53:24Z'
created_at: '2026-11-03T09:53:24Z'
total_numbers: 1
completed_count: 0
failed_count: 0
pending_count: 1
- id: 103
status: completed
processed_at: '2026-11-03T09:53:24Z'
created_at: '2026-11-03T09:53:24Z'
total_numbers: 5
completed_count: 5
failed_count: 0
pending_count: 0
pagination:
total: 2
total_pages: 1
current_page: 1
per_page: 10
'401':
description: returns unauthorized for without authentication
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Unauthorized
'403':
description: returns forbidden for without access to risk checks
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Access to API V2 risk checks is forbidden
post:
summary: Create risk check
description: '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.'
tags:
- Risk Checks
operationId: numbers_risk_checks_create
security:
- BearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
numbers:
type: array
items:
type: string
description: Array of phone numbers to check for risk
example: []
responses:
'201':
description: returns created risk check task
content:
application/json:
schema:
type: object
properties:
risk_check_request:
type: object
properties:
status:
type: string
enum:
- pending
- completed
- failed
example: pending
description: Task status
processed_at:
description: Processing completion timestamp
created_at:
type: string
example: '2026-11-03T09:53:04Z'
description: Task creation timestamp
task_id:
type: integer
example: 96
description: Task identifier
total_numbers:
type: integer
example: 2
description: Total numbers in the request
required:
- status
- processed_at
- created_at
- task_id
- total_numbers
description: Created risk check task details
required:
- risk_check_request
example:
risk_check_request:
status: pending
processed_at: null
created_at: '2026-11-03T09:53:04Z'
task_id: 96
total_numbers: 2
'401':
description: returns unauthorized for without authentication
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Unauthorized
'403':
description: returns forbidden for without access to risk checks
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Access to API V2 risk checks is forbidden
'422':
description: returns unprocessable entity when another risk check is already running
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
error:
type: string
required:
- error
examples:
returns_unprocessable_entity_for_empty_numbers:
summary: returns unprocessable entity for empty numbers
value:
errors:
numbers:
- Required
returns_unprocessable_entity_when_another_risk_check_is_already_running:
summary: returns unprocessable entity when another risk check is already running
value:
error: Previous check is still in progress
servers:
- url: https://app.didlogic.com
description: Production
/api/v2/numbers/risk_checks/logs:
get:
summary: List risk check logs
description: 'Retrieves risk check logs for individual phone numbers.
Returns detailed information about each number that was checked, including its risk level,
status, and processing time. Supports filtering by various criteria and pagination.
`logs[].task_id` feeds numbers_risk_checks_index (`task_ids`).'
tags:
- Risk Checks
operationId: numbers_risk_checks_logs
security:
- BearerAuth: []
parameters:
- name: ids
in: query
required: false
schema:
type: string
example: 171,172
description: Filter logs by log IDs (comma-separated)
- name: task_ids
in: query
required: false
schema:
type: integer
example: 101
description: Task IDs (comma-separated) from numbers_risk_checks_create, numbers_risk_checks_index
- name: number
in: query
required: false
schema:
type: string
example: 79991234567,79991234568
description: Filter logs by specific phone numbers (comma-separated)
- name: status
in: query
required: false
schema:
type: string
enum:
- pending
- completed
- failed
example: completed,pending,failed
description: Filter by status
- name: risk_level
in: query
required: false
schema:
type: string
enum:
- Low
- High
example: High,Low
description: Filter logs by risk level
- name: created_at_from
in: query
required: false
schema:
type: string
format: date
example: '2026-11-02'
description: Filter created from this date (YYYY-MM-DD)
- name: created_at_to
in: query
required: false
schema:
type: string
format: date
example: '2026-11-04'
description: Filter created until this date (YYYY-MM-DD)
- name: processed_at_from
in: query
required: false
schema:
type: string
format: date
example: '2026-11-02'
description: Filter processed from this date (YYYY-MM-DD)
- name: processed_at_to
in: query
required: false
schema:
type: string
format: date
example: '2026-11-04'
description: Filter processed until this date (YYYY-MM-DD)
- name: order_by
in: query
required: false
schema:
type: string
example: created_at
description: Field to sort by
- name: order
in: query
required: false
schema:
type: string
enum:
- asc
- desc
default: desc
example: desc
description: Sort order
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
example: 1
description: Page number for pagination (starts from 1)
- name: per_page
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 20
example: 10
description: Number of items per page
responses:
'200':
description: returns risk check logs
content:
application/json:
schema:
type: object
properties:
logs:
type: array
items:
type: object
properties:
id:
type: integer
example: 164
description: Log identifier
number:
type: string
example: '79991234568'
description: Phone number that was checked
status:
type: string
enum:
- pending
- completed
- failed
example: completed
description: Check status
risk_level:
type: string
enum:
- Low
- High
example: Low
description: Risk assessment level
category:
description: Risk category
task_id:
type: integer
example: 97
description: Parent task identifier
processed_at:
type: string
example: '2026-11-03T09:53:17Z'
description: Processing completion timestamp
created_at:
type: string
example: '2026-11-03T09:53:17Z'
description: Log creation timestamp
required:
- id
- number
- status
- risk_level
- category
- task_id
- processed_at
- created_at
description: List of risk check logs
pagination:
type: object
properties:
total:
type: integer
example: 2
description: Total number of items
total_pages:
type: integer
example: 1
description: Total number of pages
current_page:
type: integer
example: 1
description: Current page number
per_page:
type: integer
example: 10
description: Items per page
required:
- total
- total_pages
- current_page
- per_page
description: Pagination metadata
required:
- logs
- pagination
example:
logs:
- id: 164
number: '79991234568'
status: completed
risk_level: Low
category: null
task_id: 97
processed_at: '2026-11-03T09:53:17Z'
created_at: '2026-11-03T09:53:17Z'
- id: 163
number: '79991234567'
status: completed
risk_level: High
category: SPAMMER
task_id: 97
processed_at: '2026-11-03T09:53:17Z'
created_at: '2026-11-03T09:53:17Z'
pagination:
total: 2
total_pages: 1
current_page: 1
per_page: 10
'401':
description: returns unauthorized for without authentication
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Unauthorized
'403':
description: returns forbidden for without access to risk checks
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
example:
error: Access to API V2 risk checks is forbidden
servers:
- url: https://app.didlogic.com
description: Production
components:
schemas:
Error:
type: object
description: Standard error response. `errors` maps a field name (or `base` for errors not tied to a specific field) to an array of human-readable messages.
required:
- errors
properties:
errors:
type: object
additionalProperties:
type: array
items:
type: string
example:
base:
- data not found
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: Authenticate API requests via API key like "Bearer YOUR_TOKEN"
x-refined-from:
- didlogic-com-public-api-openapi.yaml
- didlogic-com-openapi.yml