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, in lower-case snake_case (e.g. exchange, payment_service_provider). See Entity Types. Other spellings (Exchange, payment service provider) return no results.
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, medium, high (lower-case; other values return no results).

note

is_mica_compliant and is_risk_assessed are returned on entities (see Response Parameters) but are not accepted as filters. Filter on them client-side.

Entity Types

Values are returned and filtered in lower-case snake_case. Common 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
wallet	Wallet providers
service	Other crypto services
mining_pool	Mining pools
mixing_service	Mixing / tumbling services
gambling	Gambling platforms
decentralized_service	Decentralized services

The directory can return further types (e.g. bank, investment_management_firm); treat the list as open.

Response

read-vasp-directory-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_mica_compliant": false,
        "is_risk_assessed": false,
        "is_verified": true,
        "risk_assessment": { "score": 5, "severity": "low" },
        "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 in lower-case snake_case (exchange, dex, payment_service_provider, …).
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, medium, or high.
data.entities[].is_mica_compliant	Boolean. true if the entity is compliant with the EU MiCA standards.
data.entities[].is_risk_assessed	Boolean. true if the entity's risk has been assessed (by Scorechain).
data.entities[].updated_at	Last update timestamp (ISO 8601 format).
data.entities[].url	Website URL of the entity.

caution

risk_assessment is an empty array ([]) for entities that have not been risk-assessed, instead of an object. Check for it before reading score / severity.

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.

note

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.