VASP Directory
The VASP Directory API provides access to an extensive directory of Virtual Asset Service Providers. Use these endpoints for pre-transaction screening, compliance research, and counterparty risk assessment.
Read VASP Directory
Retrieve VASP entities with comprehensive filtering by country, entity type, risk level, network status, and verification status.
Endpoint
GET {{BASE_URL}}/travel-rule/vasp-directory/read
Query Parameters
All parameters are optional. Without parameters, the endpoint returns the first 25 entities.
| Parameter | Required | Type | Description |
|---|---|---|---|
| page | No | integer | Page number. Defaults to 1. |
| per_page | No | integer | Results per page. Defaults to 25, max 100. |
| search | No | string | Search by entity name, legal name, or identifiers. |
| start_date | No | string | Filter by update date. DD-MM-YYYY format. |
| end_date | No | string | Filter by update date. DD-MM-YYYY format. |
| countries[] | No | array | Filter by country names (e.g., United Kingdom). |
| entity_type[] | No | array | Filter by entity type: Exchange, ATM, Dex, Payment Service Provider, NFT Marketplace, Donations, Bot, Sanction list. |
| in_network | No | boolean | Filter by network status. true = in Travel Rule network. |
| is_verified | No | boolean | Filter by verification status. true = verified entity. |
| risk_severity[] | No | array | Filter by risk: LOW_RISK, MEDIUM_RISK, HIGH_RISK. |
Entity Types
| Type | Description |
|---|---|
| Exchange | Cryptocurrency trading platforms |
| ATM | Cryptocurrency ATM operators |
| Dex | Decentralized exchange platforms |
| Payment Service Provider | Crypto payment processing services |
| NFT Marketplace | Non-fungible token trading platforms |
| Donations | Donation and charity platforms |
| Bot | Automated trading or service bots |
| Sanction list | Entities on sanctions lists |
Response
{
"error": false,
"status": "SUCCESS",
"data": {
"entities": [
{
"_id": "6954cd24706f4f6d1c90353a",
"entity_name": "GlobalCrypto Exchange",
"entity_legal_name": "Global Crypto Exchange Inc.",
"entity_type": "Exchange",
"countries": ["United States", "United Kingdom"],
"in_network": true,
"is_verified": true,
"risk_assessment": { "score": 5, "severity": "LOW_RISK" },
"updated_at": "2025-04-14T14:08:07.000Z",
"url": "https://www.globalcrypto.com"
}
],
"pagination": { }
}
}
Response Parameters
| Parameter | Description |
|---|---|
| data.entities[]._id | Unique identifier of the VASP entity. |
| data.entities[].entity_name | Common name of the VASP. |
| data.entities[].entity_legal_name | Official registered legal name. |
| data.entities[].entity_type | Entity category (Exchange, ATM, Dex, etc.). |
| data.entities[].countries | Array of countries where the entity operates. |
| data.entities[].in_network | Whether the entity is part of the Travel Rule network. |
| data.entities[].is_verified | Whether the entity has been verified. |
| data.entities[].risk_assessment.score | Numerical risk score. |
| data.entities[].risk_assessment.severity | Risk level: LOW_RISK, MEDIUM_RISK, or HIGH_RISK. |
| data.entities[].updated_at | Last update timestamp (ISO 8601 format). |
| data.entities[].url | Website URL of the entity. |
VASP Directory Detail
Retrieve detailed information for a specific VASP entity by its unique identifier.
Endpoint
GET {{BASE_URL}}/travel-rule/vasp-directory/detail
Query Parameters
You must provide the VASP entity identifier using either search (preferred) or entity_id as a fallback.
| Parameter | Required | Type | Description |
|---|---|---|---|
| search | Yes* | string | The unique _id of the VASP entity to retrieve. Preferred parameter. |
| entity_id | Yes* | string | Alternative parameter accepting the VASP entity _id. Used as a fallback when search is not provided. |
At least one of search or entity_id must be provided. If both are omitted (or empty), the request fails with 422 and an error message: search (entity id) is required.
Sample Request
GET {{BASE_URL}}/travel-rule/vasp-directory/detail?search=ENTITY_ID
The response structure is identical to Read VASP Directory, with the entities array containing exactly one entity.