Skip to main content
Search

Detect Address

Version: 3.0.0

Method​

POST

Url​

https://platform.globaltravelrule.com/api/verify/v2/auto_address_vasp_detection

Authentication​

No authentication

Path Parameters​

No path parameters

Query Parameters​

No query parameters

Request Body (Optional)​

address
RequiredString
address is beneficiary address (in all scenario)
Min Length0
Max Length256
Example
E9aX7TbJqvLwzC1f8rYpBnGks3M0QHjVxODUZ_WRmT2yXoLp
network
RequiredString
Network name in short symbol, the reference can check the table.
Min Length0
Max Length64
Example
XRP
publicKey
OptionalString
public key in Curve25519 algorithm. (No need to do base64 if you're using GTR package)
Min Length0
Max Length8192
Example
0szeNNub/IGoe623JCGD4B4bH8I94FozOeZjv1dKlXQ=
sourceVaspCode
OptionalString
*Required if you're TRSP type user, that you have to bring your member vasp's GTR vaspCode here, that we can recognize who made this travel rule.
Min Length0
Max Length32
Example
MAkGAda4ac
tag
OptionalString
some of network like XRP required to input address tag (memo)
Min Length0
Max Length64
Example
466489710
txId
OptionalString
*if the travel rule is after on chain, then the txId is required. the tx id format type can check the table.
Min Length0
Max Length256
Example
d1029841dacb031098288b257b628a967eb963bbaccf954506ad0694219497a4
vaspCode
RequiredString
vaspCode in GTR system, this is unique id for each VASP.
Min Length0
Max Length64
Example
MAkGAda4ac

Responses​

Status 200​

OK

JSON Content​

[+]data
OptionalObject
verifyMessage
OptionalString
verifyStatus
RequiredInteger (int32)
VerifyStatus
Example
100000

Status HTTP Status: 200, VerifyStatus: 100000​

Success (Always success)

JSON Content​

[+]data
OptionalObject
verifyMessage
OptionalString
verifyStatus
RequiredInteger (int32)
VerifyStatus
Example
100000

Request Example 1: Address Routing Verify(Pre-transaction situation)​

{
  "vaspCode": "[VASP Code]",
  "publicKey": "[Public Key]",
  "address": "[Beneficiary Address: 0x339facb1153e01d1e0d21e378da56d851da25ade]",
  "tag": "[TAG-(XRP/XLM/TON), leave blank if not applicable: 164392432]",
  "network": "[NETWORK NAME: ETH]",
  "txId": null
}

Request Example 2: Address Routing Verify(Post-transaction situation)​

{
  "vaspCode": "[VASP Code]",
  "publicKey": "[Public Key]",
  "address": "[*In Post-transaction travel rule, still using Beneficiary Address: 0x339facb1153e01d1e0d21e378da56d851da25ade]",
  "tag": "[TAG-(XRP/XLM/TON), leave blank if not applicable: 164392432]",
  "network": "[NETWORK NAME: ETH]",
  "txId": "F4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16"
}

Response Example: Success (Always success)​

HTTP Status: 200, VerifyStatus: 100000

{
  "data": {
    "vaspCode": "[VASP Code]",
    "publicKey": "[Public Key]"
  },
  "verifyMessage": "success",
  "verifyStatus": 100000
}