Verify TX ID Existence

Version: 3.0.0

Method

POST

Url

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

This API endpoint is to verify the txId and beneficiary address. You're the beneficiary and have received the funds from the blockchain. Please use the txId with beneficiary address (from your system) to query the counter-party VASP (Originator) to confirm the transaction exists. Only necessary if you're using asynchronous API flow and call this API before sending PII verification.

Authentication

No authentication

Path Parameters

No path parameters

Query Parameters

No query parameters

Request Body (Required)

Schema

address

RequiredString

address is beneficiary address (in all scenario)

Example

E9aX7TbJqvLwzC1f8rYpBnGks3M0QHjVxODUZ_WRmT2yXoLp

network

RequiredString

Network name in short symbol, the reference can check the table.

Min Length1

Example

XRP

requestId

RequiredString

requestId is the unique id for all transaction, the same travelrule-request invoke process flow should be using same requestId, the recommend format is: "[YOUR_VASP_NAME]-[UUIDv4]"

Min Length4

Max Length64

Pattern

[\w\d_=-]+

Example

testexchange-189e9948-64c7-4a6c-bb4f-859c173321c5

tag

OptionalString

some of network like XRP required to input address tag (memo)

Example

some of network like XRP required to input address tag (memo)

targetVaspCode

RequiredString

targetVaspCode here is the counter-party VASP that you want to send the travel rule request (*Not the assets transfer direction), vaspCode is GTR system's format

Example

MAkGAda4ac

ticker

RequiredString

ticker (coin) is the symbol of coin money, could refer to CMC

Min Length1

Example

USDT

txId

RequiredString

*if the travel rule is after on chain, then the txId is required. the tx id format type can check the table.

Min Length1

Example

d1029841dacb031098288b257b628a967eb963bbaccf954506ad0694219497a4

Example

{
  "ticker": "USDT",
  "address": "E9aX7TbJqvLwzC1f8rYpBnGks3M0QHjVxODUZ_WRmT2yXoLp",
  "requestId": "testexchange-189e9948-64c7-4a6c-bb4f-859c173321c5",
  "txId": "d1029841dacb031098288b257b628a967eb963bbaccf954506ad0694219497a4",
  "tag": "some of network like XRP required to input address tag (memo)",
  "network": "XRP",
  "targetVaspCode": "MAkGAda4ac"
}

Responses

Status HTTP Status: 200, VerifyStatus: 200007

TX ID Not found case

JSON Content

Schema

[+]data

OptionalObject

verifyMessage

OptionalString

verifyStatus

OptionalInteger (int32)

Example

{
  "verifyStatus": 200007,
  "verifyMessage": "TX ID Not Found"
}

Status HTTP Status: 200, VerifyStatus: 100000

Success case

JSON Content

Schema

[+]data

OptionalObject

verifyMessage

OptionalString

verifyStatus

OptionalInteger (int32)

Example

{
  "verifyStatus": 100000,
  "verifyMessage": "Verify Success"
}