Overview

Use this method to retrieve detailed information about a specific VASP from the Sumsub VASP directory by its unique identifier (ID).

Request example

curl -X GET \
     'https://api.sumsub.com/resources/api/vasps/68501e980dd5de1d3bafde29/one

Response explained

The response is a JSON file containing detailed information about a specific VASP found by its ID.

Field	Type	Description
`items`	Array of objects	Each object represents a found VASP with specific details included.

`items` element fields

The following table describes the element fields that represent specific details of the VASP.

Field	Type	Description
`supportsSnsProtocol`	Boolean	Indicates if a VASP is reachable via Sumsub Protocol (`true`), or not (`false`).
`supportsGtrProtocol`	Boolean	Indicates if a VASP is reachable via GTR Protocol (`true`) or not (`false`).
`supportsCodeProtocol`	Boolean	Indicates if a VASP is reachable via CODE Protocol (`true`) or not (`false`).
`id`	String	Unique identifier of the VASP.
`createdAt`	Date	Date and time when the VASP was created in the Sumsub directory.
`name`	String	VASP name as it is registered in the directory.
`type`	Enum string	Type of the VASP. Possible values are the following: `cexLicensed` — Centralized exchange operating under a regulatory license. `cexUnlicensed` — Centralized exchange operating without a regulatory license. `p2pLicensed` — Licensed peer-to-peer (P2P) exchange platform. `p2pUnlicensed` — Peer-to-peer (P2P) exchange platform without licensing. `wallet` — Wallet service provider (custodial or non-custodial). `payment` — Payment processor or merchant service provider. `atm` — Cryptocurrency ATM or kiosk operator. `cryptoCustodian` — Institutional crypto custodian services. `otc` — Over-the-counter trading desk. `other` — Other type not covered by the categories above.
`companyInfos`	Object	Includes general information of the VASP with the `score` assigned. The information is grouped into a list of objects representing the VASP registrations in different countries under particular legal names.
`url`	String	VASP official website.
`email`	String	Official VASP email address for contacts.
`verificationId`	String	VASP verification identifier.
`essentialChecksStatus`	String	Status of the Essential Checks. `initiated` — VASP checks have been initiated. `essentialChecksDone` — Essential Check has been completed. `extendedEssentialChecksDone` — Extended Essential Check has been completed. `rejected` — VASP is rejected due to the Essential Checks results.
`riskScoreAnswer`	Double	Data based on the vendor information about VASP type: `GREEN` — if the VASP type is `exchange_licensed` `YELLOW` — if the VASP type is `exchange_unlicensed`, `payment`, `other`, `atm`, `p2p_exchange_unlicensed`, `marketplace`, `liquidity_pools`, `transparent`, `gambling`. `RED` — otherwise.
`riskTags`	Array of enum strings	Risk tags associated with this VASP. Possible values are the following: `childExploitation` — Child exploitation. `darkMarket` — Darknet marketplace. `darkService` — Darknet services like hosting, communications. `enforcementAction` — Assets under investigation or seized by authorities. `fraudulentExchange` — Fraudulent or fake exchanges, rug pulls. `gambling` — High-risk/unlicensed gambling. `illegalService` — General illegal services, not darknet-specific. `ransomware` — Ransomware-related wallets. `sanctions` — Sanctioned entities (OFAC/UN/EU lists). `scam` — Investment scams, ponzi schemes, phishing. `stolenFunds` — Hacked or stolen funds. `terrorismFinancing` — Terrorism financing.
`hidden`	Boolean	If this parameter returns `true`, it indicates that this VASP should be ignored (for example, it is a duplicate but remains in the system). ⚠️ Warning! Hidden VASPs must never be exposed to end users. These entries represent illicit actors, inactive services, or non-customer-facing crypto infrastructure and are intended solely for attribution.

`companyInfos` attributes

The following table explains the companyInfos attributes.

Field	Type	Description
`list`	Array of objects	Includes general information of the VASP with the `score` assigned. Each object represents an individual VASP registration in a certain country and/or under a particular legal name.
`modifiedAt`	Date	Date and time when the `list` was last updated.

`list` element fields

The following table describes the list element fields that provide specific details about a VASP.

Field	Type	Description
`legalName`	String	Legally registered name of the VASP.
`licenseAuthority`	String	Alpha-3 country code (ISO 3166-1) of the country where the VASP must be licensed.
`address`	Object	VASP address details.
`registrationNumber`	String	VASP legal registration number.
`status`	String	VASP legal status. `regulated` — VASP is under the supervision of one or more financial regulatory authorities. `licensed` — VASP holds an official license (or permit) issued by a relevant government body. `unlicensed` — VASP does not hold a valid license in the given jurisdiction. “Unlicensed” does not necessarily mean illegal activity in every jurisdiction but does indicate an absence of the required license. `temporaryExemption` — VASP is temporarily exempt from certain regulatory or licensing requirements.
`supervisorAuthority`	String	Name of the authorized body overseeing the VASP.
`score`	Double	General score on the VASP profile based on the `scoreCriteria`.
`scoreCriteria`	Array of objects	Includes different types of score criteria with individual score to each type.
`scoreModifiedAt`	Date	Date and time when the score was last modified.

`address` attributes

Field	Type	Description
`buildingName`	String	Building name.
`flatNumber`	String	Flat or apartment number.
`subStreet`	String	Additional information related to the street. This could be a house number or any other details.
`subStreetEn`	String	Automatic transliteration of the additional information related to the street into Latin characters.
`street`	String	Street name.
`streetEn`	String	Automatic transliteration of the street name into Latin characters.
`state`	String	State, region, district, county or another territorial entity inside a country.
`stateEn`	String	Automatic transliteration of the territorial entity into Latin characters.
`buildingNumber`	String	Building number.
`town`	String	City, town, or another settlement.
`townEn`	String	Automatic transliteration of the settlement into Latin characters.
`postCode`	String	Address postal code.
`country`	String	Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
`formattedAddress`	String	Address in a human readable format. For example, `Design Offices, Philipsbornstraße 2, 30165 Hannover, Germany`.

Response example

{
  "id" : "68501e980dd5de1d3bafde29",
  "createdAt" : "2025-06-16 13:39:36+0000",
  "createdBy" : "[email protected]",
  "name" : "Bybit EU",
  "companyInfos" : {
    "list" : [ {
      "legalName" : "Bybit EU GmbH",
      "licenseAuthority" : "AUT",
      "address" : {
        "buildingName" : "",
        "flatNumber" : "",
        "subStreet" : "",
        "street" : "",
        "state" : "19, Wagramer Straße, Wien, Wien, Wien, 1120",
        "buildingNumber" : "",
        "town" : "",
        "postCode" : "",
        "country" : "AUT",
        "formattedAddress" : "19, Wagramer Straße, Wien, Wien, Wien, 1120, Austria"
      },
      "registrationNumber" : "FN636180i",
      "leiCode" : "",
      "status" : "licensed",
      "supervisorAuthority" : "",
      "scoreCriteria" : [ {
        "score" : 30,
        "type" : "companyStatus"
      }, {
        "score" : 0,
        "type" : "companyRegulation"
      }, {
        "score" : 0,
        "type" : "country"
      }, {
        "score" : 0,
        "type" : "riskScore"
      }, {
        "score" : 0,
        "type" : "aml"
      }, {
        "type" : "scam"
      } ]
    } ]
  },
  "url" : "https://www.bybit.eu",
  "email" : "[email protected]",
  "emailInviteSentAt" : "2025-06-16 13:39:36+0000",
  "verificationId" : "686973f9235534ad544e4c5d",
  "clientId" : "bybit.eu.com_111255",
  "vaspInfos" : [ {
    "id" : "45e8f5eb-8097-4b4a-b5ca-351f8a8ba12f",
    "source" : "gtr",
    "externalId" : "YUtdNXPA03YkyZipCi12h",
    "name" : "bybit-eu"
  }, {
    "id" : "9f5c2661-c3a7-4e8e-bda0-e2ed9f36210f",
    "source" : "chainalysis",
    "externalId" : "Bybit.eu",
    "name" : "bybit.eu"
} ],
  "essentialChecksStatus" : "extendedEssentialChecksDone",
  "dueDiligenceStatus" : "completed",
  "riskScoreAnswer" : "GREEN",
  "hidden" : false,
  "codeSettings" : {
    "isEnabled" : false
  },
  "gtrSettings" : {
    "isEnabled" : false
  },
  "sygnaSettings" : {
    "isEnabled" : false
  },
  "createDuplicateOnSandbox" : false,
  "supportsSnsProtocol" : true,
  "supportsGtrProtocol" : true,
  "supportsCodeProtocol" : false,
  "supportsSygnaProtocol" : false,
  "parentVaspId" : "6911ade5c0478871deaa60a0"
}

Overview

Request example

Response explained

items element fields

companyInfos attributes

list element fields

address attributes

Response example

`items` element fields

`companyInfos` attributes

`list` element fields

`address` attributes