# TravelRuleApi All URIs are relative to https://developers.fireblocks.com/reference/ Method | HTTP request | Description ------------- | ------------- | ------------- [**createTrustProofOfAddress**](#createTrustProofOfAddress) | **POST** /screening/travel_rule/providers/trust/proof_of_address | Create Trust Network Proof of Address [**getTrustProofOfAddress**](#getTrustProofOfAddress) | **GET** /screening/travel_rule/providers/trust/proof_of_address/{transactionId} | Retrieve Trust Network Proof of Address Signature [**getVASPByDID**](#getVASPByDID) | **GET** /screening/travel_rule/vasp/{did} | Get VASP details [**getVASPs**](#getVASPs) | **GET** /screening/travel_rule/vasp | Get All VASPs [**getVaspForVault**](#getVaspForVault) | **GET** /screening/travel_rule/vault/{vaultAccountId}/vasp | Get assigned VASP to vault [**setVaspForVault**](#setVaspForVault) | **POST** /screening/travel_rule/vault/{vaultAccountId}/vasp | Assign VASP to vault [**updateVasp**](#updateVasp) | **PUT** /screening/travel_rule/vasp/update | Add jsonDidKey to VASP details [**validateFullTravelRuleTransaction**](#validateFullTravelRuleTransaction) | **POST** /screening/travel_rule/transaction/validate/full | Validate Full Travel Rule Transaction # **createTrustProofOfAddress** > TrustProofOfAddressCreateResponse createTrustProofOfAddress(trustProofOfAddressRequest) Creates a cryptographic proof of address ownership for TRUST network. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiCreateTrustProofOfAddressRequest, TrustProofOfAddressCreateResponse } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiCreateTrustProofOfAddressRequest = { // TrustProofOfAddressRequest trustProofOfAddressRequest: param_value, // string | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. (optional) idempotencyKey: idempotencyKey_example, }; fireblocks.travelRule.createTrustProofOfAddress(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **trustProofOfAddressRequest** | **[TrustProofOfAddressRequest](../models/TrustProofOfAddressRequest.md)**| | **idempotencyKey** | [**string**] | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. | (optional) defaults to undefined ### Return type **[TrustProofOfAddressCreateResponse](../models/TrustProofOfAddressCreateResponse.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **201** | Proof of address transaction created successfully | * X-Request-ID -
| **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **getTrustProofOfAddress** > TrustProofOfAddressResponse getTrustProofOfAddress() Retrieves the TRUST-compatible encoded signature for a proof of address transaction. Send this signature directly to TRUST for verification. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiGetTrustProofOfAddressRequest, TrustProofOfAddressResponse } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiGetTrustProofOfAddressRequest = { // string | Fireblocks transaction ID (UUID format) transactionId: 550e8400-e29b-41d4-a716-446655440000, }; fireblocks.travelRule.getTrustProofOfAddress(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **transactionId** | [**string**] | Fireblocks transaction ID (UUID format) | defaults to undefined ### Return type **[TrustProofOfAddressResponse](../models/TrustProofOfAddressResponse.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Encoded signature retrieved successfully | * X-Request-ID -
| **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **getVASPByDID** > TravelRuleVASP getVASPByDID() Get VASP Details. Returns information about a VASP that has the specified DID. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiGetVASPByDIDRequest, TravelRuleVASP } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiGetVASPByDIDRequest = { // string did: did_example, // TravelRuleFieldsEnum | A CSV of fields to return. Choose from the following options: (optional) fields: param_value, }; fireblocks.travelRule.getVASPByDID(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **did** | [**string**] | | defaults to undefined **fields** | **Array<'did' | 'name' | 'verificationStatus' | 'addressLine1' | 'addressLine2' | 'city' | 'country' | 'emailDomains' | 'website' | 'logo' | 'legalStructure' | 'legalName' | 'yearFounded' | 'incorporationCountry' | 'isRegulated' | 'otherNames' | 'identificationType' | 'identificationCountry' | 'businessNumber' | 'regulatoryAuthorities' | 'jurisdictions' | 'street' | 'number' | 'unit' | 'postCode' | 'state' | 'certificates' | 'description' | 'travelRule_OPENVASP' | 'travelRule_SYGNA' | 'travelRule_TRISA' | 'travelRule_TRLIGHT' | 'travelRule_EMAIL' | 'travelRule_TRP' | 'travelRule_SHYFT' | 'travelRule_USTRAVELRULEWG' | 'createdAt' | 'createdBy' | 'updatedAt' | 'updatedBy' | 'lastSentDate' | 'lastReceivedDate' | 'documents' | 'hasAdmin' | 'isNotifiable' | 'issuers'>** | A CSV of fields to return. Choose from the following options: | (optional) defaults to undefined ### Return type **[TravelRuleVASP](../models/TravelRuleVASP.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Transaction validated successfully | - | **400** | Invalid request body | - | **500** | Internal server error | - | [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **getVASPs** > TravelRuleGetAllVASPsResponse getVASPs() Get All VASPs. Returns a list of VASPs. VASPs can be searched and sorted. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiGetVASPsRequest, TravelRuleGetAllVASPsResponse } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiGetVASPsRequest = { // 'ASC' | 'DESC' | Field to order by (optional) order: ASC, // number | Records per page (optional) pageSize: 10, // TravelRuleFieldsEnum | CSV of fields to return (all, \"blank\" or see list of all field names below) (optional) fields: param_value, // string | Search query (optional) search: Fireblocks, // 'TRUSTED' | 'BLOCKED' | 'MANUAL' | 'null' | Filter by the VASP\'s review status. Possible values include: \"TRUSTED\", \"BLOCKED\", \"MANUAL\", or \"NULL\". When provided, only VASPs that match the specified reviewValue will be returned (i.e., VASPs that have already been reviewed to this status). (optional) reviewValue: TRUSTED, // string | Cursor for pagination. When provided, the response will include the next page of results. (optional) pageCursor: 100, }; fireblocks.travelRule.getVASPs(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **order** | [**'ASC' | 'DESC'**]**Array<'ASC' | 'DESC'>** | Field to order by | (optional) defaults to undefined **pageSize** | [**number**] | Records per page | (optional) defaults to 500 **fields** | **Array<'did' | 'name' | 'verificationStatus' | 'addressLine1' | 'addressLine2' | 'city' | 'country' | 'emailDomains' | 'website' | 'logo' | 'legalStructure' | 'legalName' | 'yearFounded' | 'incorporationCountry' | 'isRegulated' | 'otherNames' | 'identificationType' | 'identificationCountry' | 'businessNumber' | 'regulatoryAuthorities' | 'jurisdictions' | 'street' | 'number' | 'unit' | 'postCode' | 'state' | 'certificates' | 'description' | 'travelRule_OPENVASP' | 'travelRule_SYGNA' | 'travelRule_TRISA' | 'travelRule_TRLIGHT' | 'travelRule_EMAIL' | 'travelRule_TRP' | 'travelRule_SHYFT' | 'travelRule_USTRAVELRULEWG' | 'createdAt' | 'createdBy' | 'updatedAt' | 'updatedBy' | 'lastSentDate' | 'lastReceivedDate' | 'documents' | 'hasAdmin' | 'isNotifiable' | 'issuers'>** | CSV of fields to return (all, \"blank\" or see list of all field names below) | (optional) defaults to undefined **search** | [**string**] | Search query | (optional) defaults to undefined **reviewValue** | [**'TRUSTED' | 'BLOCKED' | 'MANUAL' | 'null'**]**Array<'TRUSTED' | 'BLOCKED' | 'MANUAL' | 'null'>** | Filter by the VASP\'s review status. Possible values include: \"TRUSTED\", \"BLOCKED\", \"MANUAL\", or \"NULL\". When provided, only VASPs that match the specified reviewValue will be returned (i.e., VASPs that have already been reviewed to this status). | (optional) defaults to undefined **pageCursor** | [**string**] | Cursor for pagination. When provided, the response will include the next page of results. | (optional) defaults to undefined ### Return type **[TravelRuleGetAllVASPsResponse](../models/TravelRuleGetAllVASPsResponse.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Get all VASPs | - | **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **getVaspForVault** > TravelRuleVaspForVault getVaspForVault() Get assigned VASP Did for a specific vault. Returns empty string vaspDid value in response if none assigned. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiGetVaspForVaultRequest, TravelRuleVaspForVault } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiGetVaspForVaultRequest = { // string | The ID of the vault account vaultAccountId: 1, }; fireblocks.travelRule.getVaspForVault(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **vaultAccountId** | [**string**] | The ID of the vault account | defaults to undefined ### Return type **[TravelRuleVaspForVault](../models/TravelRuleVaspForVault.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | OK | * X-Request-ID -
| **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **setVaspForVault** > TravelRuleVaspForVault setVaspForVault(travelRuleVaspForVault, ) Sets the VASP Did for a specific vault. Pass empty string to remove existing one. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiSetVaspForVaultRequest, TravelRuleVaspForVault } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiSetVaspForVaultRequest = { // TravelRuleVaspForVault travelRuleVaspForVault: param_value, // string | The ID of the vault account vaultAccountId: vaultAccountId_example, // string | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. (optional) idempotencyKey: idempotencyKey_example, }; fireblocks.travelRule.setVaspForVault(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **travelRuleVaspForVault** | **[TravelRuleVaspForVault](../models/TravelRuleVaspForVault.md)**| | **vaultAccountId** | [**string**] | The ID of the vault account | defaults to undefined **idempotencyKey** | [**string**] | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. | (optional) defaults to undefined ### Return type **[TravelRuleVaspForVault](../models/TravelRuleVaspForVault.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **201** | OK | * X-Request-ID -
| **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **updateVasp** > TravelRuleUpdateVASPDetails updateVasp(travelRuleUpdateVASPDetails) Update VASP Details. Updates a VASP with the provided parameters. Use this endpoint to add your public jsonDIDkey generated by Notabene. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiUpdateVaspRequest, TravelRuleUpdateVASPDetails } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiUpdateVaspRequest = { // TravelRuleUpdateVASPDetails travelRuleUpdateVASPDetails: param_value, // string | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. (optional) idempotencyKey: idempotencyKey_example, }; fireblocks.travelRule.updateVasp(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **travelRuleUpdateVASPDetails** | **[TravelRuleUpdateVASPDetails](../models/TravelRuleUpdateVASPDetails.md)**| | **idempotencyKey** | [**string**] | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. | (optional) defaults to undefined ### Return type **[TravelRuleUpdateVASPDetails](../models/TravelRuleUpdateVASPDetails.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | VASP updated successfully | - | **400** | Invalid request body | - | **500** | Internal server error | - | [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md) # **validateFullTravelRuleTransaction** > TravelRuleValidateTransactionResponse validateFullTravelRuleTransaction(travelRuleValidateFullTransactionRequest) Validate Full Travel Rule transactions. Checks for all required information on the originator and beneficiary VASPs. ### Example ```typescript import { readFileSync } from 'fs'; import { Fireblocks, BasePath } from '@fireblocks/ts-sdk'; import type { FireblocksResponse, TravelRuleApiValidateFullTravelRuleTransactionRequest, TravelRuleValidateTransactionResponse } from '@fireblocks/ts-sdk'; // Set the environment variables for authentication process.env.FIREBLOCKS_BASE_PATH = BasePath.Sandbox; // or assign directly to "https://sandbox-api.fireblocks.io/v1" process.env.FIREBLOCKS_API_KEY = "my-api-key"; process.env.FIREBLOCKS_SECRET_KEY = readFileSync("./fireblocks_secret.key", "utf8"); const fireblocks = new Fireblocks(); let body: TravelRuleApiValidateFullTravelRuleTransactionRequest = { // TravelRuleValidateFullTransactionRequest travelRuleValidateFullTransactionRequest: param_value, // TravelRuleNotationEnum | Specifies the notation of the transaction. Possible values are: - `notabene`: Uses Notabene notation (default behavior). - `fireblocks`: Uses Fireblocks notation, with automatic translation of asset tickers and amounts. - ``: Defaults to `notabene` for backward compatibility. **Note:** The default value for the `notation` parameter will change from `notabene` to `fireblocks` Update your integrations accordingly. (optional) notation: param_value, // string | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. (optional) idempotencyKey: idempotencyKey_example, }; fireblocks.travelRule.validateFullTravelRuleTransaction(body).then((res: FireblocksResponse) => { console.log('API called successfully. Returned data: ' + JSON.stringify(res, null, 2)); }).catch((error:any) => console.error(error)); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **travelRuleValidateFullTransactionRequest** | **[TravelRuleValidateFullTransactionRequest](../models/TravelRuleValidateFullTransactionRequest.md)**| | **notation** | **Array<'fireblocks' | 'notabene'>** | Specifies the notation of the transaction. Possible values are: - `notabene`: Uses Notabene notation (default behavior). - `fireblocks`: Uses Fireblocks notation, with automatic translation of asset tickers and amounts. - `<none>`: Defaults to `notabene` for backward compatibility. **Note:** The default value for the `notation` parameter will change from `notabene` to `fireblocks` Update your integrations accordingly. | (optional) defaults to undefined **idempotencyKey** | [**string**] | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours. | (optional) defaults to undefined ### Return type **[TravelRuleValidateTransactionResponse](../models/TravelRuleValidateTransactionResponse.md)** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Transaction validated successfully | - | **0** | Error Response | * X-Request-ID -
| [[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)