Query the originating VASP by TXID.
In the case where an anonymous transaction has made, you can verify if it was generated from one of CODE members, and query the entity ID by calling this API.
This API searches for TXID originators only among CODE members. A NOT_FOUND_TXID response indicates that the TXID was either generated by a non-CODE member or there was a temporary server issue.
❗️The Txid or tx hash must always be used exactly as provided in the blockchain Node Output data. Adding '0x' in front of the tx hash may cause a mismatch. Therefore, please ensure that '0x' is not included unless it is present in the Node Output.
❗️After making a request to an API that operates asynchronously, you can either receive the result using a Callback URL or check the result via the 'Search VASP by TXID Result' API. The result data is the same for both methods.
❗️If the
currencyandnetworkparameters are entered, GTR member VASPs will also be searched. Providing these parameters is recommended for more comprehensive search results. For coin-specific network information, please refer to the interoperability page with other protocols.
Request
| Name | Required | Description |
|---|---|---|
| txid | Required | TXID |
| vout | Optional | An identifier for UTXO-type coins, used when multiple blockchain transactions share a single TXID and form a group. |
| currency | Optional | If entered, member companies affiliated with GTR will also be searched. |
| network | Optional | This is required to distinguish coins that exist across multiple networks. VASPs integrated with other solution providers may require this information, so please refer to the interoperability page with other protocols. If entered, member companies affiliated with GTR will also be searched. |
| requestId | Required | This is the request ID for querying the result. It must be unique. |
| callbackUrl | Optional | Callback URL in https:// format to receive the result. |
{
"txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
"vout": "",
"currency": "xrp",
"network": "xrp",
"requestId": "b09c8d00-8da9-11ec-b909-0242ac120002",
"callbackUrl": "https://endpoint.com"
}
Response
| Name | Required | Description |
|---|---|---|
| result | Required | Result for a request. |
| requestId | Required | This is the request ID for querying the result. It must be unique |
result: Result for a request.
-SUCCESS: Returned in the case of a valid request