Skip to main content
Search

03-VASP Detail

  • Get detailed information of a specific VASP from GTR server after performing address routing detection.
  • This API is called after selecting a VASP from the VASP list and performing address routing to determine the correct VASP entity.
  • It retrieves comprehensive details including public keys, supported features, and PII requirements necessary for Travel Rule verification.

Expected Request (VASP → GTR)​

  • Method: GET
  • Base URL: https://uat-platform.globaltravelrule.com
  • Endpoint: /api/common/v3/vasp/detail
  • Query Parameters:
    • vaspCode - Required string parameter to specify the VASP code obtained from address routing
  • Authentication:
    • mTLS (Mutual Transport Layer Security) when sending the API
    • JWT Bearer Token or App Token authentication via Authorization header
  • Header:
    • Content-Type: application/json
    • Authorization: Bearer [JWT_TOKEN] or X-Authorization: [APP_TOKEN]
  • Body: No request body required for this GET request.
set -e

export CURL_SSL_BACKEND="openssl"

curl -v --silent --location --request GET 'https://uat-platform.globaltravelrule.com/api/common/v3/vasp/detail?vaspCode=[VASP_CODE]' \
    -k --cert ./certificate.pem --key ./privateKey.pem \
    --header 'Content-Type: application/json' \
    --header 'ignore-detect: true' \
    # Please use one of Authorization or X-Authorization
    --header 'Authorization: Bearer [JWT_TOKEN]' \
    --header 'X-Authorization: [APP_TOKEN]'

Hint:

  • [VASP_CODE] should be obtained from address routing detection API first
  • This API must be called after performing address routing to ensure correct VASP entity
  • The response contains critical information needed for Travel Rule verification
  • Public key information is essential for encrypting PII data

Materials:

Expected Response (GTR → VASP)​

  • HTTP Status Code: 200
{
    "verifyStatus": 100000,
    "verifyMessage": "Success",
    "data": {
        "vaspCode": "lDPwXEIe6r1jZp5TdTfyI",
        "vaspEntitySlug": "axchange-us",
        "vaspEntityName": "Axchange USA",
        "allianceName": "Smile Travel Rule",
        "country": "US",
        "availability": 0,
        "supportedFeatures": ["UNHOSTED_WALLET_VERIFY"],
        "capability": {
          "couldPending": true
        },
        "supportedVerifyFields": [
            {
                "id": 110026,
                "name": "Beneficiary Legal Person Name"
            }
        ],
        "requiredPiiFieldsAsBeneficiary": [
            {
                "id": 110026,
                "name": "Beneficiary Legal Person Name",
                "direction": "BENEFICIARY"
            }
        ],
        "standardInfo": {
            "publicKeyInfo": {
                "receiverKeyInfo": {
                    "publicKey": "-----BEGIN CERTIFICATE-----\nMIICpzCC...."
                },
                "secretAlgorithm": "rsa_ecb_oaep_with_sha1_and_mgf1padding"
            },
            "supportedPiiSpecInfo": {
                "piiSpecVersion": "ivms101-2020"
            },
            "piiSecretFormatType": "FULL_JSON_OBJECT_ENCRYPT"
        }
    }
}