Skip to content

Screening history (v2)

GET
/screening/history

Your screening history, newest first, with cursor pagination. Replaces GET /apiv2/aml/history.

Version 1 pages by number, and the order is by creation time: while a client walks from page 1 to page 2 new checks arrive and push everything down, so records repeat and records are missed. A cursor points at a place in the set rather than at its ordinal number.

The order is created_at DESC, id DESC, and both fields are in the cursor because created_at is not unique. The cursor is opaque — pass it back exactly as received. The filters are part of the cursor: reusing a cursor with a different filter returns 400 rather than silently switching to another set. next_cursor is null at the end of the set; there is no total count.

Every filter is optional, unlike version 1 where address and network were required. Checks with status skipped are included: the address had no blockchain activity, so it was never sent to the provider and never charged, but the order is real.

An item carries the order, request, check and risk blocks field for field as in the full response, plus sanctions.verdict. It does not carry provider_data, exposure, rules, entities, wallet, billing or precheck: one Elliptic result is around 150 KB, and a page of fifty would be seven megabytes.

Authorizations

ApiKeyAuth

API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.

Type
API Key (header: X-API-KEY)

Parameters

Query Parameters

address
Type
string
Min Length
10
Max Length
128
network
Type
string
Example"trx"
provider
Type
string
Example"elliptic"
status
Type
string
Valid values
"pending""processing""completed""skipped""failed"
from

Only checks created at or after this moment, RFC 3339.

Type
string
Example"2026-09-01T00:00:00Z"
to

Only checks created at or before this moment, RFC 3339.

Type
string
cursor

Opaque cursor from the previous page. Keep the filters unchanged while paging.

Type
string
limit
Type
integer
Minimum
1
Maximum
200
Default
50

Responses

A page of the history.

application/json
JSON
{
  
"schema_version": 2,
  
"items": [
  
  
{
  
  
  
"order": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"request": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"check": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"risk": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"sanctions": {
  
  
  
  
"verdict": "string",
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"additionalProperties": "string"
  
  
}
  
],
  
"next_cursor": "string",
  
"limit": 0,
  
"additionalProperties": "string"
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI