{
  "info": {
    "name": "RoxCustody API",
    "description": "RoxCustody integration API. Set the baseUrl variable to your environment (https://YOUR-SUBDOMAIN.api-sandbox.roxcustody.com/api for sandbox, https://YOUR-SUBDOMAIN.api.roxcustody.com/api for production) and apiKey to your vault API key, then run Authentication → Generate Tokens: it stores accessToken and refreshToken for every other request.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "e18b130c2ce68efdcb622ed7",
    "version": "2.0.0"
  },
  "item": [
    {
      "name": "Authentication",
      "description": "Every API call is made on behalf of one vault. Your vault has an API key, which you create in the RoxCustody dashboard (Vault settings, API keys). Exchange it for a short-lived access token with Generate Tokens, then send the token in the X-ACCESS-TOKEN header of every other request.\n\nToken lifetimes: the access token is valid for 30 minutes (expiresAt is its expiry as a Unix timestamp in milliseconds); the refresh token is valid for 180 days. When the access token expires, requests fail with HTTP 498 and code E01403: call Refresh Token to get a new pair. Each refresh token can be used once, and the new pair replaces the old one. If the refresh token is no longer valid, start a new session with Generate Tokens.\n\nRate limits: Generate Tokens accepts 10 requests per minute; Refresh Token accepts 2 requests per second. All other endpoints accept up to 500 requests per second per vault. Beyond these limits, the API returns HTTP 429 with code E00404.",
      "item": [
        {
          "name": "Generate Tokens",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/auth/generate-tokens",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "auth",
                "generate-tokens"
              ]
            },
            "description": "Exchanges your vault API key for an access token and a refresh token. This is the first call of every integration. Store both tokens securely; send the access token in the X-ACCESS-TOKEN header of all other requests.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"apiKey\": \"{{apiKey}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Tokens Generated",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/generate-tokens",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "generate-tokens"
                  ]
                }
              },
              "status": "Tokens Generated",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"message\": \"Vault API Keys generated successfully\",\n    \"data\": {\n        \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n        \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n        \"expiresAt\": 1767258052423\n, \n        \"vaultId\": 1\n     },\n    \"status\": 201\n}"
            },
            {
              "name": "Invalid API Key",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/generate-tokens",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "generate-tokens"
                  ]
                }
              },
              "status": "Invalid API Key",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 400,\n    \"message\": \"Invalid API Key\",\n    \"errors\": {\n        \"message\": \"Invalid API Key\"\n    },\n    \"code\": \"E00401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/generate-tokens",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "generate-tokens"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 422,\n    \"message\": \"apiKey must be a string\",\n    \"errors\": {\n        \"message\": \"apiKey must be a string\",\n        \"apiKey\": [\n            \"apiKey must be a string\",\n            \"The apiKey must not exceed 255 characters\",\n            \"apiKey should not be empty\"\n        ]\n    },\n    \"code\": \"E00402\"\n}"
            },
            {
              "name": "Too Many Requests",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/generate-tokens",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "generate-tokens"
                  ]
                }
              },
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 429,\n  \"message\": \"Too many requests\",\n  \"errors\": {\n    \"message\": \"Too many requests\"\n  },\n  \"code\": \"E00404\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const body = pm.response.json();",
                  "if (body && body.data && body.data.accessToken) {",
                  "  pm.collectionVariables.set(\"accessToken\", body.data.accessToken);",
                  "  pm.collectionVariables.set(\"refreshToken\", body.data.refreshToken);",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "Refresh Token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/auth/refresh-token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "auth",
                "refresh-token"
              ]
            },
            "description": "Returns a new access token and a new refresh token. Call it when a request fails with HTTP 498 (token expired). The refresh token you send is consumed: use the new one next time.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"refreshToken\": \"{{refreshToken}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Tokens Refreshed",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Tokens Refreshed",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"message\": \"Vault API Keys generated successfully\",\n    \"data\": {\n        \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n        \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n        \"expiresAt\": 1767258052423\n    },\n    \"status\": 201\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 422,\n    \"message\": \"refreshToken must be a string\",\n    \"errors\": {\n        \"message\": \"refreshToken must be a string\",\n        \"refreshToken\": [\n            \"refreshToken must be a string\",\n            \"The refreshToken must not exceed 255 characters\",\n            \"refreshToken should not be empty\"\n        ]\n    },\n    \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Refresh Token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Invalid Refresh Token",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 401,\n    \"message\": \"Invalid refresh token\",\n    \"errors\": {\n        \"message\": \"Invalid refresh token\"\n    },\n    \"code\": \"E01402\"\n}"
            },
            {
              "name": "Refresh Token Expired Or No Longer Valid",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Refresh Token Expired Or No Longer Valid",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 401,\n    \"message\": \"Refresh token is no longer valid. Please generate a new session.\",\n    \"errors\": {\n        \"message\": \"Refresh token is no longer valid. Please generate a new session.\"\n    },\n    \"code\": \"E01402\"\n}"
            },
            {
              "name": "Concurrent Refresh",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Concurrent Refresh",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 401,\n  \"message\": \"Another process is already generating tokens for this vault\",\n  \"errors\": {\n    \"message\": \"Another process is already generating tokens for this vault\"\n  },\n  \"code\": \"E01402\"\n}"
            },
            {
              "name": "Too Many Requests",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/auth/refresh-token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "auth",
                    "refresh-token"
                  ]
                }
              },
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 429,\n  \"message\": \"Too many requests\",\n  \"errors\": {\n    \"message\": \"Too many requests\"\n  },\n  \"code\": \"E00404\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const body = pm.response.json();",
                  "if (body && body.data && body.data.accessToken) {",
                  "  pm.collectionVariables.set(\"accessToken\", body.data.accessToken);",
                  "  pm.collectionVariables.set(\"refreshToken\", body.data.refreshToken);",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Clients",
      "description": "A client is one of your own customers or users. You register them with the id you use in your system (called externalId in responses), and RoxCustody keeps their funds separate from everyone else's. Clients exist only in API vaults (segregated or consolidated crypto vaults, and fiat vaults).\n\nCrypto clients: creating a client starts the creation of their wallets, one per blockchain network enabled in the vault, in the background. Fetch them with the Wallets endpoints, or subscribe to the sync_client_wallets webhook to know when they are ready.\n\nFiat clients: created in fiat vaults. They need a legal name, and an IBAN if you want to refund their deposits.\n\nClient ids must be unique per vault. Creating a client whose id already exists returns 422 with code E03401 and lists the existing clients.",
      "item": [
        {
          "name": "Create New Client",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/clients/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "clients",
                "create"
              ]
            },
            "description": "Registers one of your customers as a client of this crypto vault. Wallet creation for every enabled network starts in the background. Only available in crypto API vaults.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"customer-1001\",\n  \"name\": \"Sara Ahmed\",\n  \"email\": \"sara@example.com\",\n  \"mobile\": \"+966500000000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Client Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "create"
                  ]
                }
              },
              "status": "Client Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client created successfully.\",\n  \"client\": {\n    \"id\": 57,\n    \"externalId\": \"customer-1001\",\n    \"name\": \"Sara Ahmed\",\n    \"email\": \"sara@example.com\",\n    \"mobile\": \"+966500000000\",\n    \"createdAt\": \"09 November, 2026 10:15:02\",\n    \"updatedAt\": \"09 November, 2026 10:15:02\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Vault Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "create"
                  ]
                }
              },
              "status": "Vault Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found, or vault type is not allowed for creating clients\",\n  \"errors\": {\n    \"message\": \"Vault not found, or vault type is not allowed for creating clients\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Client ID Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "create"
                  ]
                }
              },
              "status": "Client ID Already Exists",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Http Exception\",\n  \"errors\": {\n    \"message\": \"Http Exception\",\n    \"clients\": [\n      {\n        \"id\": 57,\n        \"externalId\": \"customer-1001\"\n      }\n    ]\n  },\n  \"code\": \"E03401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "create"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"id must be a string\",\n  \"errors\": {\n    \"message\": \"id must be a string\",\n    \"id\": [\n      \"id must be a string\",\n      \"The value must not exceed 255 characters\",\n      \"The id field is required.\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Wrong Vault Type",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "create"
                  ]
                }
              },
              "status": "Wrong Vault Type",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"This operation is allowed only for crypto vaults\",\n  \"errors\": {\n    \"message\": \"This operation is allowed only for crypto vaults\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Create Clients",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/clients/bulk-create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "clients",
                "bulk-create"
              ]
            },
            "description": "Registers several clients of this crypto vault in one call, by id only. Use Create New Client if you also want to store a name, email or mobile number. If any id already exists, nothing is created.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ids\": [\n    \"client1\",\n    \"client2\",\n    \"client3\",\n    \"client4\",\n    \"client5\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Clients Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "bulk-create"
                  ]
                }
              },
              "status": "Clients Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Clients created successfully.\",\n  \"clients\": [\n    {\n      \"id\": 57,\n      \"externalId\": \"customer-1001\",\n      \"name\": null,\n      \"email\": null,\n      \"mobile\": null,\n      \"createdAt\": \"09 November, 2026 10:15:02\",\n      \"updatedAt\": \"09 November, 2026 10:15:02\"\n    }\n  ],\n  \"status\": 201\n}"
            },
            {
              "name": "Client ID Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "bulk-create"
                  ]
                }
              },
              "status": "Client ID Already Exists",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Http Exception\",\n  \"errors\": {\n    \"message\": \"Http Exception\",\n    \"clients\": [\n      {\n        \"id\": 57,\n        \"externalId\": \"customer-1001\"\n      },\n      {\n        \"id\": 57,\n        \"externalId\": \"customer-1002\"\n      }\n    ]\n  },\n  \"code\": \"E03401\"\n}"
            },
            {
              "name": "Vault Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "bulk-create"
                  ]
                }
              },
              "status": "Vault Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found, or vault type is not allowed for creating clients\",\n  \"errors\": {\n    \"message\": \"Vault not found, or vault type is not allowed for creating clients\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "bulk-create"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Each value must not exceed 255 characters\",\n  \"errors\": {\n    \"message\": \"Each value must not exceed 255 characters\",\n    \"ids\": [\n      \"Each value must not exceed 255 characters\",\n      \"each value in ids must be a string\",\n      \"The ids field is required.\",\n      \"ids must not be empty\",\n      \"ids must be an array\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Wrong Vault Type",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "bulk-create"
                  ]
                }
              },
              "status": "Wrong Vault Type",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"This operation is allowed only for crypto vaults\",\n  \"errors\": {\n    \"message\": \"This operation is allowed only for crypto vaults\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Create Fiat Client",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/clients/fiat/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "clients",
                "fiat",
                "create"
              ]
            },
            "description": "Registers a client in a fiat vault. Provide the IBAN if you may need to refund the client's deposits: refunds go back to this IBAN. Only available in fiat vaults.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"customer-2001\",\n  \"name\": \"Sara Ahmed Alqahtani\",\n  \"IBAN\": \"SA0380000000608010167519\",\n  \"email\": \"sara@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Client Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "create"
                  ]
                }
              },
              "status": "Client Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client created successfully.\",\n  \"client\": {\n    \"id\": 57,\n    \"externalId\": \"customer-2001\",\n    \"name\": \"Sara Ahmed Alqahtani\",\n    \"email\": \"sara@example.com\",\n    \"mobile\": \"+966500000000\",\n    \"createdAt\": \"09 November, 2026 10:15:02\",\n    \"updatedAt\": \"09 November, 2026 10:15:02\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Vault Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "create"
                  ]
                }
              },
              "status": "Vault Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found, or vault type is not allowed for creating clients\",\n  \"errors\": {\n    \"message\": \"Vault not found, or vault type is not allowed for creating clients\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Client ID Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "create"
                  ]
                }
              },
              "status": "Client ID Already Exists",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Http Exception\",\n  \"errors\": {\n    \"message\": \"Http Exception\",\n    \"clients\": [\n      {\n        \"id\": 57,\n        \"externalId\": \"customer-2001\"\n      }\n    ]\n  },\n  \"code\": \"E03401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "create"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"id must be a string\",\n  \"errors\": {\n    \"message\": \"id must be a string\",\n    \"id\": [\n      \"id must be a string\",\n      \"The value must not exceed 255 characters\",\n      \"The id field is required.\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Wrong Vault Type",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "create"
                  ]
                }
              },
              "status": "Wrong Vault Type",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"This operation is allowed only for fiat vaults\",\n  \"errors\": {\n    \"message\": \"This operation is allowed only for fiat vaults\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Bulk Create Fiat Clients",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "clients",
                "fiat",
                "bulk-create"
              ]
            },
            "description": "Registers several fiat clients in one call. Each item has the same fields as Create Fiat Client. If any id already exists, nothing is created.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"clients\": [\n    {\n      \"id\": \"customer-2001\",\n      \"name\": \"Sara Ahmed Alqahtani\",\n      \"IBAN\": \"SA0380000000608010167519\"\n    },\n    {\n      \"id\": \"customer-2002\",\n      \"name\": \"Omar Khalid Alharbi\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Clients Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "bulk-create"
                  ]
                }
              },
              "status": "Clients Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Clients created successfully.\",\n  \"clients\": [\n    {\n      \"id\": 57,\n      \"externalId\": \"customer-2001\",\n      \"name\": \"Sara Ahmed\",\n      \"email\": \"sara@example.com\",\n      \"mobile\": \"+966500000000\",\n      \"createdAt\": \"09 November, 2026 10:15:02\",\n      \"updatedAt\": \"09 November, 2026 10:15:02\"\n    }\n  ],\n  \"status\": 201\n}"
            },
            {
              "name": "Vault Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "bulk-create"
                  ]
                }
              },
              "status": "Vault Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found, or vault type is not allowed for creating clients\",\n  \"errors\": {\n    \"message\": \"Vault not found, or vault type is not allowed for creating clients\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Client ID Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "bulk-create"
                  ]
                }
              },
              "status": "Client ID Already Exists",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Http Exception\",\n  \"errors\": {\n    \"message\": \"Http Exception\",\n    \"clients\": [\n      {\n        \"id\": 57,\n        \"externalId\": \"customer-2001\"\n      }\n    ]\n  },\n  \"code\": \"E03401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "bulk-create"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"id must be a string\",\n  \"errors\": {\n    \"message\": \"id must be a string\",\n    \"id\": [\n      \"id must be a string\",\n      \"The value must not exceed 255 characters\",\n      \"The id field is required.\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Wrong Vault Type",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/clients/fiat/bulk-create",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "clients",
                    "fiat",
                    "bulk-create"
                  ]
                }
              },
              "status": "Wrong Vault Type",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"This operation is allowed only for fiat vaults\",\n  \"errors\": {\n    \"message\": \"This operation is allowed only for fiat vaults\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Wallets",
      "description": "A wallet is one blockchain address holding one asset. RoxCustody creates them for you; you never handle keys.\n\nWallet types (the \"type\" field): MASTER (the vault's own wallets), CLIENT (one per client and asset), GAS_STATION (pays network fees on behalf of other wallets), ORDER (receives one payment order) and SYSTEM_FEES.\n\nBalances are strings in the asset's normal unit (for example \"1.5\" ETH), so very large or precise amounts are never rounded. pendingBalance is the part reserved by transactions that are not completed yet.\n\nList endpoints use cursor pagination: read meta.nextCursor and pass it as the cursor query parameter.",
      "item": [
        {
          "name": "Get All Clients' Wallets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/client-wallets?limit=10&clientId=customer-1001&filters[networkId]=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                "client-wallets"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "clientId",
                  "value": "customer-1001"
                },
                {
                  "key": "filters[networkId]",
                  "value": "1"
                }
              ]
            },
            "description": "Lists client wallets in this vault, for all clients or, with clientId, for one client."
          },
          "response": [
            {
              "name": "Wallets Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallets?limit=10&clientId=customer-1001&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "clientId",
                      "value": "customer-1001"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Wallets Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Clients' Wallets\",\n  \"data\": [\n    {\n      \"id\": 80,\n      \"balance\": \"0\",\n      \"pendingBalance\": \"0\",\n      \"publicAddress\": \"npSrSWmLQv6hTPcStg44tPrqTfmTwYiy7hU8RpoTrE6\",\n      \"transactionsCount\": \"0\",\n      \"targetId\": \"2\",\n      \"protocol\": 0,\n      \"asset\": {\n        \"id\": 2168,\n        \"name\": \"USDC\",\n        \"symbol\": \"USDC\",\n        \"contractAddress\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n        \"decimals\": 6,\n        \"type\": \"TOKEN\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://api-super-admin-custody-demo.roxcustody.com/public/files/assets/usdc.png\"\n      },\n      \"type\": \"CLIENT\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Invalid Filters Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallets?limit=10&clientId=customer-1001&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "clientId",
                      "value": "customer-1001"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Invalid Filters Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\"\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Client not found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallets?limit=10&clientId=customer-1001&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "clientId",
                      "value": "customer-1001"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Client not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Client not found in this vault\",\n  \"errors\": {\n    \"message\": \"Client not found in this vault\"\n},\n  \"code\": \"E03402\"\n}"
            }
          ]
        },
        {
          "name": "Get Vault Gas Station Wallets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/gas-station-wallets?limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                "gas-station-wallets"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Lists the gas station wallets that pay network fees for this vault. Keep them funded with the network's coin, otherwise token transactions fail with insufficient gas."
          },
          "response": [
            {
              "name": "Gas Station Wallets Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/gas-station-wallets?limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "gas-station-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Gas Station Wallets Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Gas station wallets\",\n  \"data\": [\n    {\n      \"id\": 1,\n      \"balance\": \"0\",\n      \"pendingBalance\": \"0\",\n      \"publicAddress\": \"0x73dfa3ccf752B3704785EAc599F616053eFF9A81\",\n      \"transactionsCount\": \"0\",\n      \"targetId\": 1,\n      \"asset\": {\n        \"id\": 1,\n        \"name\": \"Ether\",\n        \"symbol\": \"ETH\",\n        \"contractAddress\": null,\n        \"decimals\": 18,\n        \"network\": {\n          \"id\": 1,\n          \"name\": \"Ethereum\",\n          \"symbol\": \"ETH\",\n          \"createdAt\": \"05 August, 2025 07:23:30\",\n          \"updatedAt\": \"05 August, 2025 07:23:30\",\n          \"type\": \"PUBLIC\",\n          \"status\": \"ACTIVE\",\n          \"logo\": \"https://assets.example.com/public/files/assets/ethereum.png\",\n          \"isSwappable\": true,\n          \"category\": \"EVM\",\n          \"chain\": {\n            \"id\": 1,\n            \"name\": \"Ethereum\",\n            \"nativeCurrency\": {\n              \"name\": \"Ether\",\n              \"symbol\": \"ETH\",\n              \"decimals\": 18\n            },\n            \"rpcUrls\": {\n              \"default\": {\n                \"http\": [\n                  \"https://eth.llamarpc.com\",\n                  \"https://rpc.ankr.com/eth\"\n                ]\n              }\n            },\n            \"blockExplorers\": {\n              \"default\": {\n                \"name\": \"Etherscan\",\n                \"url\": \"https://etherscan.io\",\n                \"apiUrl\": \"https://api.etherscan.io/api\"\n              }\n            }\n          }\n        },\n        \"createdAt\": \"05 August, 2025 07:23:31\",\n        \"updatedAt\": \"05 August, 2025 07:23:31\",\n        \"type\": \"COIN\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://assets.example.com/public/files/assets/ethereum.png\"\n      },\n      \"createdAt\": \"05 August, 2025 07:44:57\",\n      \"updatedAt\": \"05 August, 2025 07:44:57\",\n      \"type\": \"GAS_STATION\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Invalid Filters Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/gas-station-wallets?limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "gas-station-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Invalid Filters Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Get Wallet by ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/:walletId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                ":walletId"
              ],
              "variable": [
                {
                  "key": "walletId",
                  "value": "",
                  "description": "Wallet ID"
                }
              ]
            },
            "description": "Returns one wallet of this vault, with its current balance and pending balance."
          },
          "response": [
            {
              "name": "Wallet Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/:walletId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    ":walletId"
                  ],
                  "variable": [
                    {
                      "key": "walletId",
                      "value": "",
                      "description": "Wallet ID"
                    }
                  ]
                }
              },
              "status": "Wallet Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Wallet balance\",\n  \"data\": {\n    \"id\": 2322,\n    \"balance\": \"0\",\n    \"pendingBalance\": \"0\",\n    \"publicAddress\": \"0x102354614119CD8B3654a7D89128E0474e908705\",\n    \"transactionsCount\": \"0\",\n    \"targetId\": 14,\n    \"createdAt\": \"20 August, 2025 12:01:13\",\n    \"updatedAt\": \"20 August, 2025 12:01:13\",\n    \"type\": \"CLIENT\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/:walletId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    ":walletId"
                  ],
                  "variable": [
                    {
                      "key": "walletId",
                      "value": "",
                      "description": "Wallet ID"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Validation failed (numeric string is expected)\",\n  \"errors\": {\n    \"message\": \"Validation failed (numeric string is expected)\",\n    \"error\": \"Bad Request\",\n    \"statusCode\": 400\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Wallet Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/:walletId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    ":walletId"
                  ],
                  "variable": [
                    {
                      "key": "walletId",
                      "value": "",
                      "description": "Wallet ID"
                    }
                  ]
                }
              },
              "status": "Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find this wallet\",\n  \"errors\": {\n    \"message\": \"Can't find this wallet\"\n },\n  \"code\": \"E04401\"\n}"
            }
          ]
        },
        {
          "name": "Get Client Native Coin Wallet by Network",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-network/:networkId/:clientId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                "client-wallet-by-network",
                ":networkId",
                ":clientId"
              ],
              "variable": [
                {
                  "key": "networkId",
                  "value": "",
                  "description": "Network ID"
                },
                {
                  "key": "clientId",
                  "value": "",
                  "description": "Client ID"
                }
              ]
            },
            "description": "Returns a client's wallet for the native coin of a network (for example ETH on Ethereum). clientId here is the RoxCustody client ID (a number), not your externalId."
          },
          "response": [
            {
              "name": "Client Wallet Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-network/:networkId/:clientId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallet-by-network",
                    ":networkId",
                    ":clientId"
                  ],
                  "variable": [
                    {
                      "key": "networkId",
                      "value": "",
                      "description": "Network ID"
                    },
                    {
                      "key": "clientId",
                      "value": "",
                      "description": "Client ID"
                    }
                  ]
                }
              },
              "status": "Client Wallet Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client wallet by network\",\n  \"data\": {\n    \"id\": 439,\n    \"balance\": \"0\",\n    \"pendingBalance\": \"0\",\n    \"publicAddress\": \"0x8ba2bC564C5ddfDdb45FD1831F3A3A63A867cB39\",\n    \"transactionsCount\": \"0\",\n    \"targetId\": 4,\n    \"asset\": {\n      \"id\": 1817,\n      \"name\": \"Ether\",\n      \"symbol\": \"ETH\",\n      \"contractAddress\": null,\n      \"decimals\": 18,\n      \"network\": {\n        \"id\": 7,\n        \"name\": \"Base\",\n        \"symbol\": \"ETH\",\n        \"createdAt\": \"05 August, 2025 07:23:32\",\n        \"updatedAt\": \"05 August, 2025 07:23:32\",\n        \"type\": \"PUBLIC\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://assets.example.com/public/files/assets/base.png\",\n        \"isSwappable\": true,\n        \"category\": \"EVM\",\n        \"chain\": {\n          \"id\": 8453,\n          \"name\": \"Base\",\n          \"nativeCurrency\": {\n            \"name\": \"Ether\",\n            \"symbol\": \"ETH\",\n            \"decimals\": 18\n          },\n          \"rpcUrls\": {\n            \"default\": {\n              \"http\": [\n                \"https://mainnet.base.org\"\n              ]\n            }\n          },\n          \"blockExplorers\": {\n            \"default\": {\n              \"name\": \"Basescan\",\n              \"url\": \"https://basescan.org\",\n              \"apiUrl\": \"https://api.basescan.org/api\"\n            }\n          }\n        }\n      },\n      \"createdAt\": \"05 August, 2025 07:23:32\",\n      \"updatedAt\": \"05 August, 2025 07:23:32\",\n      \"type\": \"COIN\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://assets.example.com/public/files/assets/base.png\"\n    },\n    \"createdAt\": \"20 August, 2025 11:18:54\",\n    \"updatedAt\": \"20 August, 2025 11:18:54\",\n    \"type\": \"CLIENT\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Wallet Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-network/:networkId/:clientId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallet-by-network",
                    ":networkId",
                    ":clientId"
                  ],
                  "variable": [
                    {
                      "key": "networkId",
                      "value": "",
                      "description": "Network ID"
                    },
                    {
                      "key": "clientId",
                      "value": "",
                      "description": "Client ID"
                    }
                  ]
                }
              },
              "status": "Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find this wallet\",\n  \"errors\": {\n    \"message\": \"Can't find this wallet\"\n },\n  \"code\": \"E04401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-network/:networkId/:clientId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallet-by-network",
                    ":networkId",
                    ":clientId"
                  ],
                  "variable": [
                    {
                      "key": "networkId",
                      "value": "",
                      "description": "Network ID"
                    },
                    {
                      "key": "clientId",
                      "value": "",
                      "description": "Client ID"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Validation failed (numeric string is expected)\",\n  \"errors\": {\n    \"message\": \"Validation failed (numeric string is expected)\",\n    \"error\": \"Bad Request\",\n    \"statusCode\": 400\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get Client Wallet by Asset",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-asset/:assetId/:clientId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                "client-wallet-by-asset",
                ":assetId",
                ":clientId"
              ],
              "variable": [
                {
                  "key": "assetId",
                  "value": "",
                  "description": "Asset ID"
                },
                {
                  "key": "clientId",
                  "value": "",
                  "description": "RoxCustody client ID"
                }
              ]
            },
            "description": "Returns a client's wallet for one asset, and creates it if it does not exist yet (for example after a new token was added to the vault). clientId here is the RoxCustody client ID (a number)."
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/client-wallet-by-asset/:assetId/:clientId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    "client-wallet-by-asset",
                    ":assetId",
                    ":clientId"
                  ],
                  "variable": [
                    {
                      "key": "assetId",
                      "value": "",
                      "description": "Asset ID"
                    },
                    {
                      "key": "clientId",
                      "value": "",
                      "description": "RoxCustody client ID"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client wallet by asset\",\n  \"data\": {\n    \"id\": 2322,\n    \"balance\": \"0\",\n    \"pendingBalance\": \"0\",\n    \"publicAddress\": \"0x102354614119CD8B3654a7D89128E0474e908705\",\n    \"transactionsCount\": \"0\",\n    \"targetId\": 14,\n    \"createdAt\": \"20 August, 2025 12:01:13\",\n    \"updatedAt\": \"20 August, 2025 12:01:13\",\n    \"type\": \"CLIENT\"\n  },\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Get Wallet NFTs",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/wallets/:walletId/nfts?page=1&limit=10&filters[state]=MINTED",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "wallets",
                ":walletId",
                "nfts"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[state]",
                  "value": "MINTED"
                }
              ],
              "variable": [
                {
                  "key": "walletId",
                  "value": "",
                  "description": "Wallet ID"
                }
              ]
            },
            "description": "Lists the individual NFTs held by a wallet of this vault (one entry per token ID), across all collections."
          },
          "response": [
            {
              "name": "NFTs Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/:walletId/nfts?page=1&limit=10&filters[state]=MINTED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    ":walletId",
                    "nfts"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[state]",
                      "value": "MINTED"
                    }
                  ],
                  "variable": [
                    {
                      "key": "walletId",
                      "value": "",
                      "description": "Wallet ID"
                    }
                  ]
                }
              },
              "status": "NFTs Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Wallet NFTs\",\n  \"data\": [\n    {\n      \"assetId\": 3120,\n      \"securityTokenId\": 88,\n      \"nftTokenId\": \"1\",\n      \"holderAddress\": \"0x8C1f0b5e2a3d4c6b7e9f0a1b2c3d4e5f6a7b8c9d\",\n      \"holderWalletId\": 2322,\n      \"metadataUrl\": \"ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi/1.json\",\n      \"state\": \"MINTED\",\n      \"createdAt\": \"09 November, 2026 10:40:12\",\n      \"updatedAt\": \"09 November, 2026 10:40:12\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Wallet Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/wallets/:walletId/nfts?page=1&limit=10&filters[state]=MINTED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "wallets",
                    ":walletId",
                    "nfts"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[state]",
                      "value": "MINTED"
                    }
                  ],
                  "variable": [
                    {
                      "key": "walletId",
                      "value": "",
                      "description": "Wallet ID"
                    }
                  ]
                }
              },
              "status": "Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find this wallet\",\n  \"errors\": {\n    \"message\": \"Can't find this wallet\"\n  },\n  \"code\": \"E04401\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Vaults",
      "description": "A vault is a separate custody account inside your company's RoxCustody workspace. Your API key belongs to one vault, and every request only sees that vault's data.\n\nVault types (vaultType): api_segregated (each client gets their own wallets), api_consolidated (client balances are tracked separately but funds are held together), internal, escrow, payment (crypto payment orders), fiat_segregated and fiat_payment (fiat clients and fiat payment orders). The type decides which endpoints you can use: for example payment orders need a payment vault, and fiat endpoints need a fiat vault.\n\nApprovers: outgoing transactions may need approval by vault admins, according to the vault's payment policy. Get Vault Approvals lists these admins and Get Vault Payment Policy shows the rules.\n\nThis section also covers webhooks, which push events to your server (see the Webhooks guide).",
      "item": [
        {
          "name": "Get Vault Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/details",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "details"
              ]
            },
            "description": "Returns the vault your API key belongs to: name, type, category (CRYPTO or FIAT), allowed origins, webhook and fiat currency."
          },
          "response": [
            {
              "name": "Vault Details Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/details",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "details"
                  ]
                }
              },
              "status": "Vault Details Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Vault Details\",\n  \"data\": {\n    \"id\": 14,\n    \"name\": \"Main API Vault\",\n    \"photo\": null,\n    \"vaultType\": \"api_segregated\",\n    \"category\": \"CRYPTO\",\n    \"allowedOrigins\": [\n      \"https://app.example.com\"\n    ],\n    \"webhookId\": 3,\n    \"fiatCurrencyDetails\": {\n      \"id\": 5,\n      \"name\": \"US Dollar\",\n      \"symbol\": \"$\",\n      \"pricingId\": \"USD\"\n    },\n    \"createdAt\": \"20 August, 2025 12:01:13\",\n    \"updatedAt\": \"20 August, 2025 12:01:13\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Vault Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/details",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "details"
                  ]
                }
              },
              "status": "Vault Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found\",\n  \"errors\": {\n    \"message\": \"Vault not found\"\n  },\n  \"code\": \"E05401\"\n}"
            }
          ]
        },
        {
          "name": "Get Vault Approvals",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/approvals?page=1&limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "approvals"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Lists the admins who approve this vault's outgoing transactions."
          },
          "response": [
            {
              "name": "Vault Approvals Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/approvals?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "approvals"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Vault Approvals Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"message\": \"Vault Approvals\",\n    \"data\": {\n        \"id\": 1,\n        \"phone\": null,\n        \"name\": \"rox\",\n        \"email\": \"rox@example.com\",\n        \"isTwoFactorEnabled\": \"false\",\n        \"mustActivateTwoFactorAuth\": \"false\",\n        \"createdAt\": \"17 November, 2024 13:19:03\",\n        \"updatedAt\": \"17 November, 2024 13:44:01\"\n    },\n    \"status\": 200\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/approvals?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "approvals"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 422,\n    \"message\": \"The value for property 'roleId' must be of type number,In(number, number),NotIn(number, number).\",\n    \"errors\": {\n        \"message\": \"The value for property 'roleId' must be of type number,In(number, number),NotIn(number, number).\",\n        \"filters\": [\n            \"The value for property 'roleId' must be of type number,In(number, number),NotIn(number, number).\"\n        ]\n    },\n    \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Get Vault Assets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/assets?page=1&limit=10&filters[networkId]=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "assets"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[networkId]",
                  "value": "1"
                }
              ]
            },
            "description": "Lists the assets (coins and tokens) enabled in this vault. Use the asset id in transactions, wallet lookups and payment orders."
          },
          "response": [
            {
              "name": "Vault Assets Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/assets?page=1&limit=10&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "assets"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Vault Assets Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Vault Assets\",\n  \"data\": [\n    {\n      \"id\": 2282,\n      \"name\": \"USDC\",\n      \"symbol\": \"USDC\",\n      \"contractAddress\": \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\",\n      \"decimals\": 6,\n      \"network\": {\n        \"id\": 18,\n        \"name\": \"Solana Devnet\",\n        \"symbol\": \"SOL\",\n        \"isSwappable\": false,\n        \"chain\": {\n          \"id\": 245022926,\n          \"name\": \"Solana Devnet\",\n          \"nativeCurrency\": {\n            \"name\": \"Solana Devnet\",\n            \"symbol\": \"SOL\",\n            \"decimals\": 9\n          },\n          \"rpcUrls\": {\n            \"default\": {\n              \"http\": [],\n              \"webSocket\": []\n            }\n          },\n          \"blockExplorers\": {\n            \"default\": {\n              \"name\": \"Solscan\",\n              \"url\": \"https://solscan.io\",\n              \"apiUrl\": \"https://api.devnet.solana.com\"\n            }\n          }\n        }\n      },\n      \"createdAt\": \"28 May, 2025 08:33:03\",\n      \"updatedAt\": \"14 July, 2025 09:00:08\",\n      \"vaultStatus\": \"active\",\n      \"type\": \"TOKEN\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://assets.example.com/public/files/assets/usdc.png\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/assets?page=1&limit=10&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "assets"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to id,status,type,networkId,contractAddress,vaultAssets,vaultId,vaultAssets,status,vaultAssets,isHidden,network,isSwappable.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to id,status,type,networkId,contractAddress,vaultAssets,vaultId,vaultAssets,status,vaultAssets,isHidden,network,isSwappable.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Get Vault Networks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/networks?page=1&limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "networks"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Lists the blockchain networks enabled in this vault."
          },
          "response": [
            {
              "name": "Vault Networks Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/networks?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "networks"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Vault Networks Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Vault Networks\",\n  \"data\": [\n    {\n      \"name\": \"Solana Devnet\",\n      \"logo\": \"https://assets.example.com/public/files/assets/solana.png\",\n      \"symbol\": \"SOL\",\n      \"id\": 18,\n      \"category\": \"Solana\",\n      \"status\": \"ACTIVE\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/networks?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "networks"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"status\": 422,\n    \"message\": \"The value for property 'status' must be of type enum[HOLD,ACTIVE] .\",\n    \"errors\": {\n        \"message\": \"The value for property 'status' must be of type enum[HOLD,ACTIVE] .\",\n        \"filters\": [\n            \"The value for property 'status' must be of type enum[HOLD,ACTIVE] .\"\n        ]\n    },\n    \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Filter Values Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/networks?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "networks"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Invalid Filter Values Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to id,status,type,isSwappable.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to id,status,type,isSwappable.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Get Vault Payment Policy",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/payment-policy",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "payment-policy"
              ]
            },
            "description": "Returns the vault's payment policy: the amount ranges that decide how many approvals an outgoing transaction needs, and from whom."
          },
          "response": [
            {
              "name": "Vault Payment Policy Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/payment-policy",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "payment-policy"
                  ]
                }
              },
              "status": "Vault Payment Policy Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n    \"message\": \"Vault Payment Policy\",\n    \"data\": {\n        \"paymentPolicy\": {\n            \"id\": 26,\n            \"ranges\": [\n                {\n                    \"id\": 13,\n                    \"from\": \"0.00000000000000000000\",\n                    \"to\": \"100000.00000000000000000000\",\n                    \"dailyLimit\": null,\n                    \"createdAt\": \"20 August, 2025 14:43:29\",\n                    \"updatedAt\": \"20 August, 2025 14:43:29\",\n                    \"paymentPolicyRangeType\": \"api\",\n                    \"minimumNumberOfApprovals\": null\n                }\n            ],\n            \"createdAt\": \"20 August, 2025 14:43:29\",\n            \"updatedAt\": \"20 August, 2025 14:43:29\"\n        }\n    },\n    \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Get Master Wallet",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/master-wallets?limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "master-wallets"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                }
              ]
            },
            "description": "Lists the vault's own (MASTER) wallets, one per enabled asset."
          },
          "response": [
            {
              "name": "Master Wallets Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/master-wallets?limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "master-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Master Wallets Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"wallets\",\n  \"data\": [\n    {\n      \"id\": 82926,\n      \"balance\": \"964.551212121\",\n      \"pendingBalance\": \"0\",\n      \"publicAddress\": \"D3usfqaJLkFZXpZKovRq3tEL49sAtaqajeTZPymgQraU\",\n      \"transactionsCount\": \"0\",\n      \"targetId\": \"3\",\n      \"asset\": {\n        \"id\": 2169,\n        \"name\": \"Rox\",\n        \"symbol\": \"ROX\",\n        \"contractAddress\": null,\n        \"decimals\": 9,\n        \"network\": {\n          \"id\": 28,\n          \"name\": \"Rox Chain\",\n          \"symbol\": \"ROX\",\n          \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n          \"isSwappable\": false,\n          \"category\": \"Solana\",\n          \"chain\": {\n            \"id\": 245022934,\n            \"name\": \"Rox Chain\",\n            \"nativeCurrency\": {\n              \"name\": \"Rox\",\n              \"symbol\": \"ROX\",\n              \"decimals\": 9\n            },\n            \"rpcUrls\": {\n              \"default\": {\n                \"http\": [],\n                \"webSocket\": []\n              }\n            },\n            \"blockExplorers\": {\n              \"default\": {\n                \"name\": \"Rox chain explorer\",\n                \"url\": \"https://explorer.roxchain.io\",\n                \"apiUrl\": \"https://rpc.roxchain.io\"\n              }\n            }\n          },\n          \"addressFormat\": {\n            \"prefixes\": [\n              \"\"\n            ],\n            \"lengthRange\": [\n              32,\n              44\n            ]\n          }\n        },\n        \"vaultStatus\": \"active\",\n        \"isHidden\": false,\n        \"type\": \"COIN\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"\n      },\n      \"type\": \"MASTER\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/master-wallets?limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "master-wallets"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to publicAddress,targetId,assetId,asset,contractAddress,asset,networkId,vaultId,type,id.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Verify Webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/verify-webhook",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "verify-webhook"
              ]
            },
            "description": "Registers your webhook endpoint for this vault. RoxCustody immediately sends a test POST with an empty JSON body to the URL, signed with your secret; your server must answer with a 2xx status within 10 seconds, otherwise the call fails. Next, choose events with Create Webhook Events. A vault has one webhook.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://api.example.com/roxcustody/webhooks\",\n  \"secret\": \"a-long-random-secret-value-32ch\",\n  \"authMethod\": 2\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Webhook verified successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/verify-webhook",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "verify-webhook"
                  ]
                }
              },
              "status": "Webhook verified successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Webhook verified successfully\",\n  \"data\": {\n    \"id\": 3,\n    \"url\": \"https://api.example.com/roxcustody/webhooks\",\n    \"vaultId\": 14,\n    \"retryCount\": 5,\n    \"retryPeriod\": \"30-minute\",\n    \"authMethod\": \"HMAC\",\n    \"events\": {},\n    \"subscribedEventsCount\": 0,\n    \"eventsDescription\": {}\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Webhook Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/verify-webhook",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "verify-webhook"
                  ]
                }
              },
              "status": "Webhook Already Exists",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Webhooks already exists for this vault\",\n  \"errors\": {\n    \"message\": \"Webhooks already exists for this vault\",\n    \"error\": \"Unprocessable Entity\",\n    \"statusCode\": 422\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Webhook URL or Secret",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/verify-webhook",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "verify-webhook"
                  ]
                }
              },
              "status": "Invalid Webhook URL or Secret",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Webhook url or secret is invalid\",\n  \"errors\": {\n    \"message\": \"Webhook url or secret is invalid\",\n    \"error\": \"Unprocessable Entity\",\n    \"statusCode\": 422\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "HMAC Secret Too Short",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/verify-webhook",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "verify-webhook"
                  ]
                }
              },
              "status": "HMAC Secret Too Short",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"HMAC webhook secrets must be at least 16 characters\",\n  \"errors\": {\n    \"message\": \"HMAC webhook secrets must be at least 16 characters\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Create Webhook Events",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "create-webhook-events",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The ID of the webhook"
                }
              ]
            },
            "description": "Chooses which events are sent to your webhook, and the default retry settings. Call it once after Verify Webhook; use Update Webhook Events for later changes. To subscribe to every event available to your vault type, send \"events\": [-1].",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"retryCount\": 5,\n  \"retryPeriod\": \"30-minute\",\n  \"events\": {\n    \"transactions\": [\n      \"create_transaction\",\n      \"completed_transaction\"\n    ],\n    \"vault\": [\n      \"sync_client_wallets\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Webhook created successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Webhook created successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Webhook created successfully\",\n  \"data\": {\n    \"id\": 3,\n    \"url\": \"https://api.example.com/roxcustody/webhooks\",\n    \"vaultId\": 14,\n    \"retryCount\": 5,\n    \"retryPeriod\": \"30-minute\",\n    \"authMethod\": \"HMAC\",\n    \"events\": {\n      \"transactions\": {\n        \"create_transaction\": {\n          \"retryCount\": 5,\n          \"subscribed\": true,\n          \"retryPeriod\": \"30-minute\"\n        },\n        \"completed_transaction\": {\n          \"retryCount\": 5,\n          \"subscribed\": true,\n          \"retryPeriod\": \"30-minute\"\n        }\n      },\n      \"vault\": {\n        \"sync_client_wallets\": {\n          \"retryCount\": 5,\n          \"subscribed\": false,\n          \"retryPeriod\": \"30-minute\"\n        }\n      }\n    },\n    \"subscribedEventsCount\": 2,\n    \"eventsDescription\": {\n      \"create_transaction\": \"Fires when a new transaction is created.\",\n      \"completed_transaction\": \"Fires when a transaction is confirmed and successfully completed.\"\n    }\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Webhook Events Already Exist",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Webhook Events Already Exist",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Webhook events already exists\",\n  \"errors\": {\n    \"message\": \"Webhook events already exists\",\n    \"error\": \"Unprocessable Entity\",\n    \"statusCode\": 422\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Webhook Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Webhook Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Webhook with id=3 not found\",\n  \"errors\": {\n    \"message\": \"Webhook with id=3 not found\"\n  },\n  \"code\": \"E00403\"\n}"
            },
            {
              "name": "Invalid retryCount",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Invalid retryCount",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"retryCount must not be greater than 10\",\n  \"errors\": {\n    \"message\": \"retryCount must not be greater than 10\",\n    \"retryCount\": [\n      \"retryCount must not be greater than 10\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid retryPeriod",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Invalid retryPeriod",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Invalid value for property 'retryPeriod'. It should be one of these values: 1-minute, 5-minute, 15-minute, 30-minute, 1-hour, 2-hour, 3-hour, 4-hour, 5-hour\",\n  \"errors\": {\n    \"message\": \"Invalid value for property 'retryPeriod'. It should be one of these values: 1-minute, 5-minute, 15-minute, 30-minute, 1-hour, 2-hour, 3-hour, 4-hour, 5-hour\"\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Webhook Events Structure",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Invalid Webhook Events Structure",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Invalid webhook events structure. The valid structure is: { transactions: [create_transaction, broadcasted_transaction, rejected_transaction, error_transaction, blockchain_rejected_transaction, completed_transaction, compliance_rule_transaction, cancel_transaction, fiat_transaction_created, fiat_transaction_completed, fiat_transaction_failed, fiat_refund_created]; vault: [sync_vault_wallets, sync_client_wallets]; assets: [add_asset, activate_asset, deactivate_asset, hold_asset]; networks: [hold_network, activate_network]; tokens: [token_created_with_asset]; paymentVaultOrder: [paid_payment_vault_order, fiat_payment_vault_order_paid, fiat_payment_vault_order_refunded] }\",\n  \"errors\": {\n    \"message\": \"Invalid webhook events structure. The valid structure is: { transactions: [create_transaction, broadcasted_transaction, rejected_transaction, error_transaction, blockchain_rejected_transaction, completed_transaction, compliance_rule_transaction, cancel_transaction, fiat_transaction_created, fiat_transaction_completed, fiat_transaction_failed, fiat_refund_created]; vault: [sync_vault_wallets, sync_client_wallets]; assets: [add_asset, activate_asset, deactivate_asset, hold_asset]; networks: [hold_network, activate_network]; tokens: [token_created_with_asset]; paymentVaultOrder: [paid_payment_vault_order, fiat_payment_vault_order_paid, fiat_payment_vault_order_refunded] }\"\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Event Not Allowed For Vault Type",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/create-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "create-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Event Not Allowed For Vault Type",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"The following events are not allowed for this vault type: fiat_transaction_created\",\n  \"errors\": {\n    \"message\": \"The following events are not allowed for this vault type: fiat_transaction_created\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Update Webhook Events",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/vaults/update-webhook-events/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "vaults",
                "update-webhook-events",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The ID of the webhook"
                }
              ]
            },
            "description": "Replaces the list of events you are subscribed to. Send the full list you want: events not listed are unsubscribed. Send [-1] to subscribe to all events, or omit events (or send []) to unsubscribe from all. Per-event retry settings are kept.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"events\": {\n    \"transactions\": [\n      \"completed_transaction\",\n      \"error_transaction\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Webhook event updated successfully",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/update-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "update-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Webhook event updated successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Webhook event updated successfully\",\n  \"data\": {\n    \"id\": 3,\n    \"url\": \"https://api.example.com/roxcustody/webhooks\",\n    \"vaultId\": 14,\n    \"retryCount\": 5,\n    \"retryPeriod\": \"30-minute\",\n    \"authMethod\": \"HMAC\",\n    \"events\": {\n      \"transactions\": {\n        \"create_transaction\": {\n          \"retryCount\": 5,\n          \"subscribed\": true,\n          \"retryPeriod\": \"30-minute\"\n        },\n        \"completed_transaction\": {\n          \"retryCount\": 5,\n          \"subscribed\": true,\n          \"retryPeriod\": \"30-minute\"\n        }\n      },\n      \"vault\": {\n        \"sync_client_wallets\": {\n          \"retryCount\": 5,\n          \"subscribed\": false,\n          \"retryPeriod\": \"30-minute\"\n        }\n      }\n    },\n    \"subscribedEventsCount\": 2,\n    \"eventsDescription\": {\n      \"create_transaction\": \"Fires when a new transaction is created.\",\n      \"completed_transaction\": \"Fires when a transaction is confirmed and successfully completed.\"\n    }\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Webhook Not Found",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/update-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "update-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Webhook Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Webhook with id=3 not found\",\n  \"errors\": {\n    \"message\": \"Webhook with id=3 not found\"\n  },\n  \"code\": \"E00403\"\n}"
            },
            {
              "name": "Invalid Webhook Events Structure",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/vaults/update-webhook-events/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "vaults",
                    "update-webhook-events",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the webhook"
                    }
                  ]
                }
              },
              "status": "Invalid Webhook Events Structure",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Invalid webhook events structure. The valid structure is: { transactions: [create_transaction, broadcasted_transaction, rejected_transaction, error_transaction, blockchain_rejected_transaction, completed_transaction, compliance_rule_transaction, cancel_transaction, fiat_transaction_created, fiat_transaction_completed, fiat_transaction_failed, fiat_refund_created]; vault: [sync_vault_wallets, sync_client_wallets]; assets: [add_asset, activate_asset, deactivate_asset, hold_asset]; networks: [hold_network, activate_network]; tokens: [token_created_with_asset]; paymentVaultOrder: [paid_payment_vault_order, fiat_payment_vault_order_paid, fiat_payment_vault_order_refunded] }\",\n  \"errors\": {\n    \"message\": \"Invalid webhook events structure. The valid structure is: { transactions: [create_transaction, broadcasted_transaction, rejected_transaction, error_transaction, blockchain_rejected_transaction, completed_transaction, compliance_rule_transaction, cancel_transaction, fiat_transaction_created, fiat_transaction_completed, fiat_transaction_failed, fiat_refund_created]; vault: [sync_vault_wallets, sync_client_wallets]; assets: [add_asset, activate_asset, deactivate_asset, hold_asset]; networks: [hold_network, activate_network]; tokens: [token_created_with_asset]; paymentVaultOrder: [paid_payment_vault_order, fiat_payment_vault_order_paid, fiat_payment_vault_order_refunded] }\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Transactions",
      "description": "A transaction moves an asset on a blockchain. You create outgoing transactions; incoming ones are detected automatically and appear in the same list.\n\nLifecycle (status): PENDING (created, possibly waiting for approvers) → BROADCASTING (signed and sent to the network) → COMPLETED (confirmed on-chain). It can end instead as REJECTED (an approver refused it), CANCELLED, BLOCKCHAINREJECTED (the network refused it), INSUFFICIENTGASFEES (the gas station could not pay the fee), ERROR, or COMPLIANCE_RULE (held by a compliance rule).\n\nTypes (type): Incoming, Outgoing, Internal (between two wallets of your vault), Swap, Allowance, TOKEN_DEPLOYMENT, MINT_TOKEN, BURN_TOKEN, NFT_TRANSFER, CONTRACT_CALL and TOKEN_OPERATION.\n\nCreating a transaction only queues it: the response comes back with status PENDING. Follow it with the transaction webhooks (create_transaction, broadcasted_transaction, completed_transaction, …) or by polling Get Transaction Details. Use idempotencyKey so that a retried request never sends the money twice.\n\nAmounts are strings in the asset's normal unit (for example \"0.1\" ETH). dollarAmount and fiatAmount are the value at creation time.",
      "item": [
        {
          "name": "Create Transaction",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/transactions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "transactions"
              ]
            },
            "description": "Sends an asset from one of your clients' wallets. Choose the source in one of two ways: walletId, or clientId plus assetId. Choose the destination in one of three ways: receiverAddress (any address), receiverClientId plus assetId (another client of the vault), or toMasterWallet: true plus assetId (the vault's master wallet). The transaction is created with status PENDING and may need approvals before it is sent.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 0.1,\n  \"walletId\": 246,\n  \"receiverAddress\": \"TV77cjwVydiysagUWWDqGrqQyjfVLVyFQw\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Transaction Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Transaction Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Your transaction is pending\",\n  \"transaction\": {\n    \"id\": \"12\",\n    \"dollarAmount\": \"0.50000000000000000000\",\n    \"fiatAmount\": \"0.50000000000000000000\",\n    \"senderAddress\": \"2ohp3pBjHLMLuKgaHZguDatFY7eUZn2XiPUCA7KgGNy9\",\n    \"receiverAddress\": \"3M2vdeWjRWddacDCdKQveFHbgrfgSa8NuEjPtFjh5WHU\",\n    \"feesPayerWalletId\": \"350292\",\n    \"data\": null,\n    \"asset\": {\n      \"id\": 2170,\n      \"name\": \"Rox\",\n      \"symbol\": \"ROX\",\n      \"network\": {\n        \"id\": 29,\n        \"name\": \"Rox Chain Devnet\",\n        \"symbol\": \"ROX\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n        \"isSwappable\": false,\n        \"chain\": {\n          \"id\": 245022935,\n          \"name\": \"Rox Chain Devnet\",\n          \"nativeCurrency\": {\n            \"name\": \"Rox\",\n            \"symbol\": \"ROX\",\n            \"decimals\": 9\n          },\n          \"rpcUrls\": {\n            \"default\": {\n              \"http\": [],\n              \"webSocket\": []\n            }\n          },\n          \"blockExplorers\": {\n            \"default\": {\n              \"name\": \"Rox chain explorer\",\n              \"url\": \"https://explorer.roxchain.io\",\n              \"apiUrl\": \"https://rpc-dev.roxchain.io\"\n            }\n          },\n          \"testnet\": true\n        },\n        \"addressFormat\": null\n      },\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"\n    },\n    \"createdAt\": \"24 March, 2026 19:29:21\",\n    \"updatedAt\": \"24 March, 2026 19:29:27\",\n    \"blockExplorerUrl\": \"https://explorer.roxchain.io/tx/85299572755017334673545733533775374353542573657?cluster=devnet\",\n    \"markup\": \"0 ROX\",\n    \"approvals\": [],\n    \"type\": \"Incoming\",\n    \"transactionHash\": \"85299572755017334673545733533775374353542573657\",\n    \"status\": \"PENDING\",\n    \"coinSymbol\": \"ROX\",\n    \"paymentPolicyType\": null,\n    \"amount\": \"0.5\",\n    \"fees\": \"0.0001\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Please enter a valid amount\",\n  \"errors\": {\n    \"message\": \"Please enter a valid amount\",\n    \"amount\": [\n      \"Please enter a valid amount\",\n      \"The amount field is required.\"\n    ],\n    \"walletId\": [\n      \"The walletId field is required.\",\n      \"The value must be a number\",\n      \"The value must be a positive number\",\n      \"The value must be an integer\"\n    ],\n    \"receiverAddress\": [\n      \"receiver address must be a string\",\n      \"The value must not exceed 255 characters\",\n      \"The receiverAddress field is required.\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Insufficient Balance",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Insufficient Balance",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Insufficient balance\",\n  \"errors\": {\n    \"message\": \"Insufficient balance\"\n  },\n  \"code\": \"E02602\"\n}"
            },
            {
              "name": "Invalid Source",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Invalid Source",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Either wallet id or asset id and client id must be provided\",\n  \"errors\": {\n    \"message\": \"Either wallet id or asset id and client id must be provided\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Invalid Destination",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Invalid Destination",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Either receiver address, receiver client id and asset id, or toMasterWallet and asset id must be provided\",\n  \"errors\": {\n    \"message\": \"Either receiver address, receiver client id and asset id, or toMasterWallet and asset id must be provided\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Master Wallet Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ]
                }
              },
              "status": "Master Wallet Not Found",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Master wallet not found\",\n  \"errors\": {\n    \"message\": \"Master wallet not found\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get Transaction Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/transactions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "transactions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Transaction ID"
                }
              ]
            },
            "description": "Returns one transaction of this vault, including its status, fees, addresses, blockchain hash and approvals."
          },
          "response": [
            {
              "name": "Transaction Details Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Transaction ID"
                    }
                  ]
                }
              },
              "status": "Transaction Details Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Transaction\",\n  \"transaction\": {\n    \"id\": \"12\",\n    \"dollarAmount\": \"0.50000000000000000000\",\n    \"fiatAmount\": \"0.50000000000000000000\",\n    \"senderAddress\": \"2ohp3pBjHLMLuKgaHZguDatFY7eUZn2XiPUCA7KgGNy9\",\n    \"receiverAddress\": \"3M2vdeWjRWddacDCdKQveFHbgrfgSa8NuEjPtFjh5WHU\",\n    \"feesPayerWalletId\": \"350292\",\n    \"data\": null,\n    \"asset\": {\n      \"id\": 2170,\n      \"name\": \"Rox\",\n      \"symbol\": \"ROX\",\n      \"network\": {\n        \"id\": 29,\n        \"name\": \"Rox Chain Devnet\",\n        \"symbol\": \"ROX\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n        \"isSwappable\": false,\n        \"chain\": {\n          \"id\": 245022935,\n          \"name\": \"Rox Chain Devnet\",\n          \"nativeCurrency\": {\n            \"name\": \"Rox\",\n            \"symbol\": \"ROX\",\n            \"decimals\": 9\n          },\n          \"rpcUrls\": {\n            \"default\": {\n              \"http\": [],\n              \"webSocket\": []\n            }\n          },\n          \"blockExplorers\": {\n            \"default\": {\n              \"name\": \"Rox chain explorer\",\n              \"url\": \"https://explorer.roxchain.io\",\n              \"apiUrl\": \"https://rpc-dev.roxchain.io\"\n            }\n          },\n          \"testnet\": true\n        },\n        \"addressFormat\": null\n      },\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"\n    },\n    \"createdAt\": \"24 March, 2026 19:29:21\",\n    \"updatedAt\": \"24 March, 2026 19:29:27\",\n    \"blockExplorerUrl\": \"https://explorer.roxchain.io/tx/85299572755017334673545733533775374353542573657?cluster=devnet\",\n    \"markup\": \"0 ROX\",\n    \"approvals\": [],\n    \"type\": \"Incoming\",\n    \"transactionHash\": \"85299572755017334673545733533775374353542573657\",\n    \"status\": \"COMPLETED\",\n    \"coinSymbol\": \"ROX\",\n    \"paymentPolicyType\": null,\n    \"amount\": \"0.5\",\n    \"fees\": \"0.0001\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Transaction Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Transaction ID"
                    }
                  ]
                }
              },
              "status": "Transaction Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find transaction with id 123\",\n  \"errors\": {\n    \"message\": \"Can't find transaction with id 123\"\n  },\n  \"code\": \"E00403\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Transaction ID"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Validation failed (numeric string is expected)\",\n  \"errors\": {\n    \"message\": \"Validation failed (numeric string is expected)\",\n    \"error\": \"Bad Request\",\n    \"statusCode\": 400\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get All Transactions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/transactions?limit=10&sortKey=id&order=DESC&filters[status]=COMPLETED",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "transactions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "sortKey",
                  "value": "id"
                },
                {
                  "key": "order",
                  "value": "DESC"
                },
                {
                  "key": "filters[status]",
                  "value": "COMPLETED"
                }
              ]
            },
            "description": "Lists this vault's transactions (incoming and outgoing), newest first by default. Token deployments (TOKEN_DEPLOYMENT) and NFT transfers (NFT_TRANSFER) are not included in this list."
          },
          "response": [
            {
              "name": "Transactions Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions?limit=10&sortKey=id&order=DESC&filters[status]=COMPLETED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "sortKey",
                      "value": "id"
                    },
                    {
                      "key": "order",
                      "value": "DESC"
                    },
                    {
                      "key": "filters[status]",
                      "value": "COMPLETED"
                    }
                  ]
                }
              },
              "status": "Transactions Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"vault transactions\",\n  \"data\": [\n    {\n      \"id\": \"12\",\n      \"dollarAmount\": \"0.50000000000000000000\",\n      \"fiatAmount\": \"0.50000000000000000000\",\n      \"senderAddress\": \"2ohp3pBjHLMLuKgaHZguDatFY7eUZn2XiPUCA7KgGNy9\",\n      \"receiverAddress\": \"3M2vdeWjRWddacDCdKQveFHbgrfgSa8NuEjPtFjh5WHU\",\n      \"feesPayerWalletId\": \"350292\",\n      \"data\": null,\n      \"asset\": {\n        \"id\": 2170,\n        \"name\": \"Rox\",\n        \"symbol\": \"ROX\",\n        \"network\": {\n          \"id\": 29,\n          \"name\": \"Rox Chain Devnet\",\n          \"symbol\": \"ROX\",\n          \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n          \"isSwappable\": false,\n          \"chain\": {\n            \"id\": 245022935,\n            \"name\": \"Rox Chain Devnet\",\n            \"nativeCurrency\": {\n              \"name\": \"Rox\",\n              \"symbol\": \"ROX\",\n              \"decimals\": 9\n            },\n            \"rpcUrls\": {\n              \"default\": {\n                \"http\": [],\n                \"webSocket\": []\n              }\n            },\n            \"blockExplorers\": {\n              \"default\": {\n                \"name\": \"Rox chain explorer\",\n                \"url\": \"https://explorer.roxchain.io\",\n                \"apiUrl\": \"https://rpc-dev.roxchain.io\"\n              }\n            },\n            \"testnet\": true\n          },\n          \"addressFormat\": null\n        },\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"\n      },\n      \"createdAt\": \"24 March, 2026 19:29:21\",\n      \"updatedAt\": \"24 March, 2026 19:29:27\",\n      \"blockExplorerUrl\": \"https://explorer.roxchain.io/tx/85299572755017334673545733533775374353542573657?cluster=devnet\",\n      \"markup\": \"0 ROX\",\n      \"approvals\": [],\n      \"type\": \"Incoming\",\n      \"transactionHash\": \"85299572755017334673545733533775374353542573657\",\n      \"status\": \"COMPLETED\",\n      \"coinSymbol\": \"ROX\",\n      \"paymentPolicyType\": null,\n      \"amount\": \"0.5\",\n      \"fees\": \"0.0001\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Invalid Sort Key Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions?limit=10&sortKey=id&order=DESC&filters[status]=COMPLETED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "sortKey",
                      "value": "id"
                    },
                    {
                      "key": "order",
                      "value": "DESC"
                    },
                    {
                      "key": "filters[status]",
                      "value": "COMPLETED"
                    }
                  ]
                }
              },
              "status": "Invalid Sort Key Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"sortKey must be one of the values in id,amount,dollarAmount\",\n  \"errors\": {\n    \"message\": \"sortKey must be one of the values in id,amount,dollarAmount\"\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Order Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions?limit=10&sortKey=id&order=DESC&filters[status]=COMPLETED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "sortKey",
                      "value": "id"
                    },
                    {
                      "key": "order",
                      "value": "DESC"
                    },
                    {
                      "key": "filters[status]",
                      "value": "COMPLETED"
                    }
                  ]
                }
              },
              "status": "Invalid Order Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Invalid value for property 'order'. It should be one of these values: ASC, DESC\",\n  \"errors\": {\n    \"message\": \"Invalid value for property 'order'. It should be one of these values: ASC, DESC\",\n    \"order\": [\n      \"Invalid value for property 'order'. It should be one of these values: ASC, DESC\"\n    ]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Invalid Filters Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/transactions?limit=10&sortKey=id&order=DESC&filters[status]=COMPLETED",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "sortKey",
                      "value": "id"
                    },
                    {
                      "key": "order",
                      "value": "DESC"
                    },
                    {
                      "key": "filters[status]",
                      "value": "COMPLETED"
                    }
                  ]
                }
              },
              "status": "Invalid Filters Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to id,clientId,walletId,assetId,vaultId,blockchainTransactionId,wallet,targetId,type,status,approvalTransactionActions,action,createdAt,updatedAt,asset,networkId,senderAddress,receiverAddress.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to id,clientId,walletId,assetId,vaultId,blockchainTransactionId,wallet,targetId,type,status,approvalTransactionActions,action,createdAt,updatedAt,asset,networkId,senderAddress,receiverAddress.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Assets",
      "description": "An asset is a coin or token that the vault can hold, for example ETH on Ethereum or USDT on Tron. Every wallet, transaction and payment order refers to an asset by its id; list the vault's assets with Get Vault Assets.\n\nAsset types: COIN (the network's native currency, which also pays fees), TOKEN, and CUSTOM_TOKEN (a token your company created, for which you can set a price).",
      "item": [
        {
          "name": "Get Asset Price",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/assets/price/:assetId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "assets",
                "price",
                ":assetId"
              ],
              "variable": [
                {
                  "key": "assetId",
                  "value": "",
                  "description": "The ID of the asset to get price for"
                }
              ]
            },
            "description": "Returns the current price of an asset in your vault's fiat currency."
          },
          "response": [
            {
              "name": "Asset Price Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/price/:assetId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "price",
                    ":assetId"
                  ],
                  "variable": [
                    {
                      "key": "assetId",
                      "value": "",
                      "description": "The ID of the asset to get price for"
                    }
                  ]
                }
              },
              "status": "Asset Price Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"asset price\",\n  \"data\": {\n    \"price\": 4206.88\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Asset Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/price/:assetId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "price",
                    ":assetId"
                  ],
                  "variable": [
                    {
                      "key": "assetId",
                      "value": "",
                      "description": "The ID of the asset to get price for"
                    }
                  ]
                }
              },
              "status": "Asset Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Price for asset with id 123 not found\",\n  \"errors\": {\n    \"message\": \"Price for asset with id 123 not found\"\n  },\n  \"code\": \"E06401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/price/:assetId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "price",
                    ":assetId"
                  ],
                  "variable": [
                    {
                      "key": "assetId",
                      "value": "",
                      "description": "The ID of the asset to get price for"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Validation failed (numeric string is expected)\",\n  \"errors\": {\n    \"message\": \"Validation failed (numeric string is expected)\",\n    \"error\": \"Bad Request\",\n    \"statusCode\": 400\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Set Token Price",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/assets/set-token-price",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "assets",
                "set-token-price"
              ]
            },
            "description": "Sets the price of a token your company created (CUSTOM_TOKEN). Your company must own the token.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"assetId\": 2183,\n  \"requestedPrice\": 3,\n  \"fiatCurrencyCode\": \"USD\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Token Price Set Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/set-token-price",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "set-token-price"
                  ]
                }
              },
              "status": "Token Price Set Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Token price set\",\n  \"status\": 200\n}"
            },
            {
              "name": "Price Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/set-token-price",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "set-token-price"
                  ]
                }
              },
              "status": "Price Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"requestedPrice must be a positive number\",\n  \"errors\": {\n    \"message\": \"requestedPrice must be a positive number\",\n    \"requestedPrice\": [\"requestedPrice must be a positive number\"]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Unsupported Fiat Currency",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/assets/set-token-price",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "assets",
                    "set-token-price"
                  ]
                }
              },
              "status": "Unsupported Fiat Currency",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"The requested fiat currency is not supported.\",\n  \"errors\": {\n    \"fiatCurrencyCode\": [\n      \"The requested fiat currency is not supported\"\n    ]\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Tokens",
      "description": "Create and manage your own tokens. RoxCustody deploys the smart contract from a vault wallet, keeps the owner keys in custody, and signs every later operation (mint, burn, pause, …).\n\nTwo ways to create a token: Create Token from Template (v2, recommended) uses a versioned, audited contract template (erc20-v1 for fungible tokens, erc721-v1 for NFT collections) and lets you choose which capabilities the contract has (canMint, canBurn, canPause). Create Token (v1) is the original flow.\n\nDeployment is asynchronous: the token is returned with status PENDING and moves to DEPLOYED when the contract is on-chain (or REVERTED, INSUFFICIENT_GAS, ERROR or NONCE_TOO_LOW if it fails). Subscribe to the token_created_with_asset webhook, or poll Get Token by ID. Once deployed, the token also appears as an asset, so clients can hold it in wallets.\n\nNetwork fees are paid by the vault's gas station wallets (or by payerPublicAddress when given), so keep them funded.",
      "item": [
        {
          "name": "Get Token Supported Networks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token/supported-networks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token",
                "supported-networks"
              ]
            },
            "description": "Lists the networks where you can create fungible tokens. Use a returned id as networkId when creating a token."
          },
          "response": [
            {
              "name": "Supported Networks Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/supported-networks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    "supported-networks"
                  ]
                }
              },
              "status": "Supported Networks Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"tokenNetworks\",\n  \"data\": [\n    {\n      \"network\": {\n        \"id\": 17,\n        \"name\": \"Solana\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/solana.png\"\n      },\n      \"types\": [\n        { \"type\": 2, \"name\": \"TOKEN\" },\n        { \"type\": 3, \"name\": \"ERC20\" }\n      ]\n    },\n    {\n      \"network\": {\n        \"id\": 18,\n        \"name\": \"Solana Devnet\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/solana.png\"\n      },\n      \"types\": [\n        { \"type\": 2, \"name\": \"FUNGIBLE\" },\n        { \"type\": 3, \"name\": \"NFT\" }\n      ]\n    }\n  ],\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Create Token from Template (v2)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v2/integration/tokenization/token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v2",
                "integration",
                "tokenization",
                "token"
              ]
            },
            "description": "Creates and deploys a token from a versioned contract template. Pick the standard and template, then choose the contract's capabilities in config. This is a v2 endpoint: its URL is /api/v2/integration/tokenization/token. The token owner is either an address (ownerAddress) or one of your clients (ownerClientId): give exactly one.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"standard\": 1,\n  \"template\": \"erc20-v1\",\n  \"config\": {\n    \"canMint\": true,\n    \"canBurn\": true,\n    \"canPause\": false\n  },\n  \"networkId\": 1,\n  \"name\": \"Example Coin\",\n  \"symbol\": \"EXC\",\n  \"initialSupply\": \"1000000\",\n  \"decimals\": 18,\n  \"ownerClientId\": \"customer-1001\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Token Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v2/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v2",
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Token Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security token created successfully\",\n  \"data\": {\n    \"id\": 3,\n    \"networkId\": 18,\n    \"name\": \"SAMPLE Token\",\n    \"symbol\": \"SAM\",\n    \"decimals\": 3,\n    \"fees\": \"15000\",\n    \"contractAddress\": \"CqLkwwqZNuRhWUfGLUowgPvYUDNy5GMMKdFxhr45U3hv\",\n    \"assetId\": null,\n    \"vaultId\": 16,\n    \"ownerAddress\": \"6kU7syaT8RSEwdUajNGyBVKWLnHzu6xyeYQ3hcxc5din\",\n    \"recipientAddress\": \"2zy7WzAAUrvXZ9xDZpCYDtTV5ptrzyVWjLynnRBbuwce\",\n    \"config\": {\n      \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757922441861.json\"\n    },\n    \"verificationMessage\": null,\n    \"image\": null,\n    \"network\": {\n      \"id\": 18,\n      \"name\": \"Solana Devnet\",\n      \"symbol\": \"SOL\",\n      \"createdAt\": \"14 May, 2025 12:16:46\",\n      \"updatedAt\": \"14 May, 2025 12:16:46\",\n      \"type\": \"PUBLIC\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://assets.example.com/public/files/assets/solana.png\",\n      \"isSwappable\": false,\n      \"category\": \"Solana\",\n      \"chain\": {\n        \"id\": 245022926,\n        \"name\": \"Solana Devnet\",\n        \"nativeCurrency\": {\n          \"name\": \"Solana Devnet\",\n          \"symbol\": \"SOL\",\n          \"decimals\": 9\n        },\n        \"rpcUrls\": {\n          \"default\": {\n            \"http\": [],\n            \"webSocket\": []\n          }\n        },\n        \"blockExplorers\": {\n          \"default\": {\n            \"name\": \"Solscan\",\n            \"url\": \"https://solscan.io\",\n            \"apiUrl\": \"https://api.devnet.solana.com\"\n          }\n        }\n      }\n    },\n    \"createdAt\": \"15 September, 2025 07:47:26\",\n    \"updatedAt\": \"15 September, 2025 07:47:28\",\n    \"type\": \"TOKEN\",\n    \"status\": \"PENDING\",\n    \"verificationStatus\": \"VERIFIED\",\n    \"tokenExplorerUrl\": \"https://solscan.io/account/CqLkwwqZNuRhWUfGLUowgPvYUDNy5GMMKdFxhr45U3hv?cluster=devnet\",\n    \"initialSupply\": \"1000\",\n    \"standard\": \"ERC20\",\n    \"templateVersion\": \"erc20-v1\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v2/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v2",
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Exactly one property of the following properties must be provided: ownerAddress, ownerClientId\",\n  \"errors\": {\n    \"message\": \"Exactly one property of the following properties must be provided: ownerAddress, ownerClientId\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Create Token (v1)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token"
              ]
            },
            "description": "Creates and deploys a fungible token with the classic flow. Send the request as multipart/form-data so you can attach an image. The token owner is either an address (ownerAddress) or one of your clients (ownerClientId): give exactly one. For new integrations, prefer Create Token from Template (v2).",
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "networkId",
                  "value": "1",
                  "type": "text"
                },
                {
                  "key": "type",
                  "value": "1",
                  "type": "text"
                },
                {
                  "key": "name",
                  "value": "Example Coin",
                  "type": "text"
                },
                {
                  "key": "symbol",
                  "value": "EXC",
                  "type": "text"
                },
                {
                  "key": "initialSupply",
                  "value": "1000000",
                  "type": "text"
                },
                {
                  "key": "decimals",
                  "value": "18",
                  "type": "text"
                },
                {
                  "key": "ownerClientId",
                  "value": "customer-1001",
                  "type": "text"
                },
                {
                  "key": "image",
                  "type": "file",
                  "src": [],
                  "disabled": true
                }
              ]
            }
          },
          "response": [
            {
              "name": "Token Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Token Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security token created successfully\",\n  \"data\": {\n    \"id\": 3,\n    \"networkId\": 18,\n    \"name\": \"Sample Token\",\n    \"symbol\": \"SMT\",\n    \"decimals\": 0,\n    \"fees\": null,\n    \"contractAddress\": null,\n    \"assetId\": null,\n    \"vaultId\": 16,\n    \"ownerAddress\": \"2ZqvKiMvaTYRDoZYgsmJ3ykh6XzeSYsEDivgjPgiFSaU\",\n    \"recipientAddress\": \"A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw\",\n    \"config\": {\n      \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757328126036.json\"\n    },\n    \"verificationMessage\": null,\n    \"image\": \"https://custody-dev-public.s3.amazonaws.com/صورتي_1757328124987.jpg\",\n    \"network\": {\n      \"id\": 28,\n      \"name\": \"Rox Chain\",\n      \"symbol\": \"ROX\",\n      \"createdAt\": \"07 September, 2025 10:04:58\",\n      \"updatedAt\": \"07 September, 2025 10:04:58\",\n      \"type\": \"PUBLIC\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n      \"category\": \"Solana\"\n    },\n    \"createdAt\": \"08 September, 2025 10:42:06\",\n    \"updatedAt\": \"08 September, 2025 10:42:06\",\n    \"type\": \"Token\",\n    \"status\": \"PENDING\",\n    \"verificationStatus\": \"PENDING\",\n    \"tokenExplorerUrl\": null,\n    \"initialSupply\": \"1\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Error in provided data\",\n  \"errors\": {\n    \"initialSupply\": [\"Initial supply must be greater than or equal to 0\"]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Unsupported Network",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Unsupported Network",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Network is not supported\",\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Vault not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Vault not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found\",\n  \"errors\": {\n    \"message\": \"Vault not found\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Wallet not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ]
                }
              },
              "status": "Wallet not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find wallet with networkId: 123 for client 123 in vault 123\",\n  \"errors\": {\n    \"message\": \"Can't find wallet with networkId: 123 for client 123 in vault 123\"\n  },\n  \"code\": \"E04401\"\n}"
            }
          ]
        },
        {
          "name": "Get Token by ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The ID of the token to fetch"
                }
              ]
            },
            "description": "Returns one token of this vault: deployment status, contract address, explorer link, network and metadata."
          },
          "response": [
            {
              "name": "Token Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the token to fetch"
                    }
                  ]
                }
              },
              "status": "Token Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"token\",\n  \"data\": {\n    \"id\": 3,\n    \"networkId\": 18,\n    \"name\": \"SAMPLE Token\",\n    \"symbol\": \"SAM\",\n    \"decimals\": 3,\n    \"fees\": \"15000\",\n    \"contractAddress\": \"CqLkwwqZNuRhWUfGLUowgPvYUDNy5GMMKdFxhr45U3hv\",\n    \"assetId\": null,\n    \"vaultId\": 16,\n    \"ownerAddress\": \"6kU7syaT8RSEwdUajNGyBVKWLnHzu6xyeYQ3hcxc5din\",\n    \"recipientAddress\": \"2zy7WzAAUrvXZ9xDZpCYDtTV5ptrzyVWjLynnRBbuwce\",\n    \"config\": {\n      \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757922441861.json\"\n    },\n    \"verificationMessage\": null,\n    \"image\": null,\n    \"network\": {\n      \"id\": 18,\n      \"name\": \"Solana Devnet\",\n      \"symbol\": \"SOL\",\n      \"createdAt\": \"14 May, 2025 12:16:46\",\n      \"updatedAt\": \"14 May, 2025 12:16:46\",\n      \"type\": \"PUBLIC\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://assets.example.com/public/files/assets/solana.png\",\n      \"isSwappable\": false,\n      \"category\": \"Solana\",\n      \"chain\": {\n        \"id\": 245022926,\n        \"name\": \"Solana Devnet\",\n        \"nativeCurrency\": {\n          \"name\": \"Solana Devnet\",\n          \"symbol\": \"SOL\",\n          \"decimals\": 9\n        },\n        \"rpcUrls\": {\n          \"default\": {\n            \"http\": [],\n            \"webSocket\": []\n          }\n        },\n        \"blockExplorers\": {\n          \"default\": {\n            \"name\": \"Solscan\",\n            \"url\": \"https://solscan.io\",\n            \"apiUrl\": \"https://api.devnet.solana.com\"\n          }\n        }\n      }\n    },\n    \"createdAt\": \"15 September, 2025 07:47:26\",\n    \"updatedAt\": \"15 September, 2025 07:47:28\",\n    \"type\": \"TOKEN\",\n    \"status\": \"DEPLOYED\",\n    \"verificationStatus\": \"VERIFIED\",\n    \"tokenExplorerUrl\": \"https://solscan.io/account/CqLkwwqZNuRhWUfGLUowgPvYUDNy5GMMKdFxhr45U3hv?cluster=devnet\",\n    \"initialSupply\": \"1000\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Token Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the token to fetch"
                    }
                  ]
                }
              },
              "status": "Token Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"This token doesn't exist or not accessible.\",\n  \"errors\": {\n    \"message\": \"This token doesn't exist or not accessible.\"\n },\n  \"code\": \"E07403\"\n}"
            }
          ]
        },
        {
          "name": "Get Tokens",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token?page=1&limit=10&filters[networkId]=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[networkId]",
                  "value": "1"
                }
              ]
            },
            "description": "Lists this vault's fungible tokens."
          },
          "response": [
            {
              "name": "Tokens Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token?page=1&limit=10&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Tokens Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security tokens\",\n  \"data\": [\n    {\n      \"id\": 143,\n      \"networkId\": 28,\n      \"name\": \"Sample Token\",\n      \"symbol\": \"SMT\",\n      \"decimals\": 0,\n      \"fees\": \"15000\",\n      \"contractAddress\": \"8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n      \"assetId\": 4148,\n      \"vaultId\": 4,\n      \"ownerAddress\": \"2ZqvKiMvaTYRDoZYgsmJ3ykh6XzeSYsEDivgjPgiFSaU\",\n      \"recipientAddress\": \"A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw\",\n      \"config\": {\n        \"additional\": {\n          \"description\": \"This is a Sample Token\"\n        },\n        \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757322125713.json\"\n      },\n      \"verificationMessage\": null,\n      \"image\": \"https://custody-dev-public.s3.amazonaws.com/صورتي_1757322124788.jpg\",\n      \"network\": {\n        \"id\": 28,\n        \"name\": \"Rox Chain\",\n        \"symbol\": \"ROX\",\n        \"createdAt\": \"07 September, 2025 10:04:58\",\n        \"updatedAt\": \"07 September, 2025 10:04:58\",\n        \"type\": \"PUBLIC\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n        \"isSwappable\": false,\n        \"category\": \"Solana\"\n      },\n      \"createdAt\": \"08 September, 2025 09:02:06\",\n      \"updatedAt\": \"08 September, 2025 09:02:12\",\n      \"type\": \"NFT\",\n      \"status\": \"DEPLOYED\",\n      \"verificationStatus\": \"VERIFIED\",\n      \"tokenExplorerUrl\": \"https://roxscan.roxcustody.io/address/8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n      \"initialSupply\": \"1\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Client not found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token?page=1&limit=10&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Client not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Client not found in this vault\",\n  \"errors\": {\n    \"message\": \"Client not found in this vault\"\n},\n  \"code\": \"E03402\"\n}"
            },
            {
              "name": "Invalid Filters Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token?page=1&limit=10&filters[networkId]=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[networkId]",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "Invalid Filters Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to type,networkId,vaultId,id,status,internalOwnerType,internalOwnerTargetId,parentId,isCollection.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to type,networkId,vaultId,id,status,internalOwnerType,internalOwnerTargetId,parentId,isCollection.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Mint Tokens",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/mint",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "mint"
              ]
            },
            "description": "Creates new units of a token you own. The tokens go to recipientAddress, to a client (clientId), or to the vault's master wallet (toMasterWallet): give exactly one. Returns the ID of the blockchain transaction, which you can follow like any transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"assetId\": 2298,\n \"recipientAddress\": \"DETbUZDD6kysjw5d5LxYsw63zDsN7R1Q1cAETNKzcpMm\",\n  \"amount\": \"500\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Security token mint transaction has been created successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/mint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "mint"
                  ]
                }
              },
              "status": "Security token mint transaction has been created successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security token mint transaction has been created successfully\",\n  \"data\": {\n \"transactionId\": 5\n},\n  \"status\": 200\n}"
            },
            {
              "name": "Bad Request",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/mint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "mint"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Only one of clientId, recipientAddress, or master wallet target can be provided\",\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Client Wallet Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/mint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "mint"
                  ]
                }
              },
              "status": "Client Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find wallet for this client\",\n  \"errors\": {\n    \"message\": \"Can't find wallet for this client\"\n },\n  \"code\": \"E04401\"\n}"
            },
            {
              "name": "Asset Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/mint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "mint"
                  ]
                }
              },
              "status": "Asset Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"No coin asset found for this network\",\n  \"errors\": {\n    \"message\": \"No coin asset found for this network\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Master Wallet Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/mint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "mint"
                  ]
                }
              },
              "status": "Master Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Master wallet not found\",\"errors\":{\"message\":\"Master wallet not found\"},\"code\":\"E04401\"}"
            }
          ]
        },
        {
          "name": "Burn Tokens",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/burn",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "burn"
              ]
            },
            "description": "Destroys units of a token you own, taken from recipientAddress, from a client's wallet (clientId), or from the vault's master wallet (fromMasterWallet): give exactly one. Returns the ID of the blockchain transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n \"assetId\": 2298,\n \"recipientAddress\": \"DETbUZDD6kysjw5d5LxYsw63zDsN7R1Q1cAETNKzcpMm\",\n  \"amount\": \"500\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Security token burn transaction has been created successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/burn",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "burn"
                  ]
                }
              },
              "status": "Security token burn transaction has been created successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security token burn transaction has been created successfully\",\n  \"data\": {\n \"transactionId\": 5\n},\n  \"status\": 200\n}"
            },
            {
              "name": "Bad Request",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/burn",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "burn"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Only one of clientId, recipientAddress, or master wallet target can be provided\",\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Client Wallet Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/burn",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "burn"
                  ]
                }
              },
              "status": "Client Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find wallet for this client\",\n  \"errors\": {\n    \"message\": \"Can't find wallet for this client\"\n },\n  \"code\": \"E04401\"\n}"
            },
            {
              "name": "Asset Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/burn",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "burn"
                  ]
                }
              },
              "status": "Asset Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"No coin asset found for this network\",\n  \"errors\": {\n    \"message\": \"No coin asset found for this network\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Master Wallet Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/burn",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "burn"
                  ]
                }
              },
              "status": "Master Wallet Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Master wallet not found\",\"errors\":{\"message\":\"Master wallet not found\"},\"code\":\"E04401\"}"
            }
          ]
        },
        {
          "name": "Update Token Metadata",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                ":id",
                "metadata"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Token or NFT ID"
                }
              ]
            },
            "description": "Adds or changes metadata fields of a deployed token or NFT. The new fields are merged into the existing metadata file.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"additional\": {\n    \"description\": \"This is a test token\",\n    \"website\": \"https://example.com\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Metadata Updated Successfully",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "metadata"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token or NFT ID"
                    }
                  ]
                }
              },
              "status": "Metadata Updated Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Metadata updated successfully\",\n  \"status\": 200\n}"
            },
            {
              "name": "Token Not Found",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "metadata"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token or NFT ID"
                    }
                  ]
                }
              },
              "status": "Token Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"This token doesn't exist or not accessible.\",\n  \"errors\": {\n    \"message\": \"This token doesn't exist or not accessible.\"\n },\n  \"code\": \"E07403\"\n}"
            },
            {
              "name": "Token Not Deployed",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "metadata"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token or NFT ID"
                    }
                  ]
                }
              },
              "status": "Token Not Deployed",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Token is not in deployed status\",\n  \"errors\": {\n    \"message\": \"Token is not in deployed status\"\n },\n  \"code\": \"E07402\"\n}"
            },
            {
              "name": "Metadata URL Missing",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "metadata"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token or NFT ID"
                    }
                  ]
                }
              },
              "status": "Metadata URL Missing",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Metadata url is not defined\",\n  \"errors\": {\n    \"message\": \"Metadata url is not defined\"\n },\n  \"code\": \"E07401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/metadata",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "metadata"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token or NFT ID"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Error in provided data\",\n  \"errors\": {\n    \"additional\": [\"additional must be an object with string values only\"]\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Execute Token Operation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/:id/operations",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                ":id",
                "operations"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Token ID (from Create Token from Template)"
                }
              ]
            },
            "description": "Runs an operation on a token created from a template (v2): mint, burn, pause, unpause, or (ERC721) transfer. RoxCustody builds, signs and sends the transaction from the right wallet. The operations available depend on the token standard and on the capabilities chosen at creation. Returns the ID of the blockchain transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"operation\": \"MINT\",\n  \"params\": {\n    \"receiverAddress\": \"0x8C1f0b5e2a3d4c6b7e9f0a1b2c3d4e5f6a7b8c9d\",\n    \"amount\": \"250\"\n  },\n  \"idempotencyKey\": \"mint-2026-11-09-001\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Operation Created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/operations",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "operations"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token ID (from Create Token from Template)"
                    }
                  ]
                }
              },
              "status": "Operation Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Token operation transaction has been created successfully\",\n  \"data\": {\n    \"transactionId\": 98213,\n    \"data\": {}\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Operation Not Supported",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/operations",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "operations"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token ID (from Create Token from Template)"
                    }
                  ]
                }
              },
              "status": "Operation Not Supported",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"TRANSFER is not supported by erc20-v1 tokens\",\n  \"errors\": {\n    \"message\": \"TRANSFER is not supported by erc20-v1 tokens\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Token Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/:id/operations",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    ":id",
                    "operations"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Token ID (from Create Token from Template)"
                    }
                  ]
                }
              },
              "status": "Token Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Security token not found\",\n  \"errors\": {\n    \"message\": \"Security token not found\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "NFTs",
      "description": "NFTs are unique tokens: each one has its own token ID and metadata (name, image, attributes). In RoxCustody you create an NFT collection, then each NFT inside it is tracked individually with its current holder (see Get Collection NFTs and Get Wallet NFTs).\n\nLike fungible tokens, creation is asynchronous (status PENDING, then DEPLOYED) and network fees are paid by the vault's gas station wallets. For collections created from a template (v2), use Execute Token Operation to mint, burn and transfer.",
      "item": [
        {
          "name": "Get NFT Supported Networks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/nft/supported-networks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "nft",
                "supported-networks"
              ]
            },
            "description": "Lists the networks where you can create NFTs."
          },
          "response": [
            {
              "name": "Supported Networks Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/supported-networks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    "supported-networks"
                  ]
                }
              },
              "status": "Supported Networks Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"nftNetworks\",\n  \"data\": [\n    {\n      \"network\": {\n        \"id\": 17,\n        \"name\": \"Solana\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/solana.png\"\n      },\n      \"types\": [\n        { \"type\": 2, \"name\": \"FUNGIBLE\" },\n        { \"type\": 3, \"name\": \"NFT\" }\n      ]\n    },\n    {\n      \"network\": {\n        \"id\": 18,\n        \"name\": \"Solana Devnet\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/solana.png\"\n      },\n      \"types\": [\n        { \"type\": 2, \"name\": \"FUNGIBLE\" },\n        { \"type\": 3, \"name\": \"NFT\" }\n      ]\n    }\n  ],\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Create NFT Token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/nft",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "nft"
              ]
            },
            "description": "Creates and deploys an NFT (classic v1 flow). Send it as multipart/form-data to attach the image. The owner is either an address (ownerAddress) or one of your clients (ownerClientId): give exactly one. Set isCollection to true to create a collection, and parentId to create an NFT inside an existing collection.",
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "networkId",
                  "value": "28",
                  "type": "text"
                },
                {
                  "key": "name",
                  "value": "Sample Token",
                  "type": "text"
                },
                {
                  "key": "symbol",
                  "value": "SMT",
                  "type": "text"
                },
                {
                  "key": "ownerAddress",
                  "value": "A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw",
                  "type": "text"
                },
                {
                  "key": "idempotencyKey",
                  "value": "unique-key",
                  "type": "text"
                },
                {
                  "key": "additional",
                  "value": "{\"description\": \"This is a Sample Token\", \"key_1\": \"value 1\", \"key_2\": \"value 2\"}",
                  "type": "text"
                },
                {
                  "key": "image",
                  "type": "file",
                  "src": [],
                  "disabled": true
                }
              ]
            }
          },
          "response": [
            {
              "name": "NFT Token Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ]
                }
              },
              "status": "NFT Token Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security token created successfully\",\n  \"data\": {\n    \"childrenCount\": 0,\n    \"id\": 146,\n    \"networkId\": 28,\n    \"name\": \"Sample Token\",\n    \"symbol\": \"SMT\",\n    \"decimals\": 0,\n    \"fees\": null,\n    \"contractAddress\": null,\n    \"assetId\": null,\n    \"vaultId\": 4,\n    \"ownerAddress\": \"2ZqvKiMvaTYRDoZYgsmJ3ykh6XzeSYsEDivgjPgiFSaU\",\n    \"recipientAddress\": \"A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw\",\n    \"config\": {\n      \"additional\": {\n        \"description\": \"This is a Sample Token\"\n      },\n      \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757328126036.json\"\n    },\n    \"verificationMessage\": null,\n    \"image\": \"https://custody-dev-public.s3.amazonaws.com/صورتي_1757328124987.jpg\",\n    \"network\": {\n      \"id\": 28,\n      \"name\": \"Rox Chain\",\n      \"symbol\": \"ROX\",\n      \"createdAt\": \"07 September, 2025 10:04:58\",\n      \"updatedAt\": \"07 September, 2025 10:04:58\",\n      \"type\": \"PUBLIC\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n      \"category\": \"Solana\"\n    },\n    \"parent\": null,\n    \"createdAt\": \"08 September, 2025 10:42:06\",\n    \"updatedAt\": \"08 September, 2025 10:42:06\",\n    \"type\": \"NFT\",\n    \"status\": \"PENDING\",\n    \"isCollection\": \"false\",\n    \"verificationStatus\": \"PENDING\",\n    \"tokenExplorerUrl\": null,\n    \"initialSupply\": \"1\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Vault not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ]
                }
              },
              "status": "Vault not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Vault not found\",\n  \"errors\": {\n    \"message\": \"Vault not found\"\n  },\n  \"code\": \"E05401\"\n}"
            },
            {
              "name": "Wallet not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ]
                }
              },
              "status": "Wallet not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Can't find wallet with networkId: 123 for client 123 in vault 123\",\n  \"errors\": {\n    \"message\": \"Can't find wallet with networkId: 123 for client 123 in vault 123\"\n  },\n  \"code\": \"E04401\"\n}"
            },
            {
              "name": "Coin asset not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ]
                }
              },
              "status": "Coin asset not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"No coin asset found for this network\",\n  \"errors\": {\n    \"message\": \"No coin asset found for this network\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Category not supported",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ]
                }
              },
              "status": "Category not supported",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Category is not supported\",\n  \"errors\": {\n    \"message\": \"Category is not supported\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get NFT Token by ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/nft/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "nft",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The ID of the NFT token to fetch"
                }
              ]
            },
            "description": "Returns one NFT or NFT collection of this vault."
          },
          "response": [
            {
              "name": "NFT Token Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the NFT token to fetch"
                    }
                  ]
                }
              },
              "status": "NFT Token Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"token\",\n  \"data\": {\n    \"childrenCount\": 0,\n    \"id\": 143,\n    \"networkId\": 28,\n    \"name\": \"Sample Token\",\n    \"symbol\": \"SMT\",\n    \"decimals\": 0,\n    \"fees\": \"15000\",\n    \"contractAddress\": \"8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n    \"assetId\": 4148,\n    \"vaultId\": 4,\n    \"ownerAddress\": \"2ZqvKiMvaTYRDoZYgsmJ3ykh6XzeSYsEDivgjPgiFSaU\",\n    \"recipientAddress\": \"A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw\",\n    \"config\": {\n      \"additional\": {\n        \"description\": \"This is a Sample Token\"\n      },\n      \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757322125713.json\"\n    },\n    \"verificationMessage\": null,\n    \"image\": \"https://custody-dev-public.s3.amazonaws.com/صورتي_1757322124788.jpg\",\n    \"network\": {\n      \"id\": 28,\n      \"name\": \"Rox Chain\",\n      \"symbol\": \"ROX\",\n      \"createdAt\": \"07 September, 2025 10:04:58\",\n      \"updatedAt\": \"07 September, 2025 10:04:58\",\n      \"type\": \"PUBLIC\",\n      \"status\": \"ACTIVE\",\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n      \"isSwappable\": false,\n      \"category\": \"Solana\",\n      \"chain\": {\n        \"id\": 245022934,\n        \"name\": \"Rox Chain\",\n        \"nativeCurrency\": {\n          \"name\": \"Rox\",\n          \"symbol\": \"ROX\",\n          \"decimals\": 9\n        },\n        \"rpcUrls\": {\n          \"default\": {\n            \"http\": [],\n            \"webSocket\": []\n          }\n        },\n        \"blockExplorers\": {\n          \"default\": {\n            \"name\": \"Rox chain explorer\",\n            \"url\": \"https://roxscan.roxcustody.io\",\n            \"apiUrl\": \"https://rpc.example.com\"\n          }\n        }\n      }\n    },\n    \"parent\": null,\n    \"createdAt\": \"08 September, 2025 09:02:06\",\n    \"updatedAt\": \"08 September, 2025 09:02:12\",\n    \"type\": \"NFT\",\n    \"status\": \"DEPLOYED\",\n    \"verificationStatus\": \"VERIFIED\",\n    \"tokenExplorerUrl\": \"https://roxscan.roxcustody.io/address/8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n    \"isCollection\": \"false\",\n    \"initialSupply\": \"1\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Token Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "The ID of the NFT token to fetch"
                    }
                  ]
                }
              },
              "status": "Token Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"This token doesn't exist or not accessible.\",\n  \"errors\": {\n    \"message\": \"This token doesn't exist or not accessible.\"\n },\n  \"code\": \"E07403\"\n}"
            }
          ]
        },
        {
          "name": "Get NFT Tokens",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/nft?page=1&limit=10&filters[isCollection]=true",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "nft"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[isCollection]",
                  "value": "true"
                }
              ]
            },
            "description": "Lists this vault's NFTs and NFT collections."
          },
          "response": [
            {
              "name": "NFT Tokens Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft?page=1&limit=10&filters[isCollection]=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[isCollection]",
                      "value": "true"
                    }
                  ]
                }
              },
              "status": "NFT Tokens Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Security tokens\",\n  \"data\": [\n    {\n      \"id\": 143,\n      \"networkId\": 28,\n      \"name\": \"Sample Token\",\n      \"symbol\": \"SMT\",\n      \"decimals\": 0,\n      \"fees\": \"15000\",\n      \"contractAddress\": \"8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n      \"assetId\": 4148,\n      \"vaultId\": 4,\n      \"ownerAddress\": \"2ZqvKiMvaTYRDoZYgsmJ3ykh6XzeSYsEDivgjPgiFSaU\",\n      \"recipientAddress\": \"A51iQm72KSwsYVrFaPye8HDo1nJUGjKaYGStKEQo4gaw\",\n      \"config\": {\n        \"additional\": {\n          \"description\": \"This is a Sample Token\"\n        },\n        \"metadataUrl\": \"https://custody-dev-public.s3.amazonaws.com/sample_token_1757322125713.json\"\n      },\n      \"verificationMessage\": null,\n      \"image\": \"https://custody-dev-public.s3.amazonaws.com/صورتي_1757322124788.jpg\",\n      \"network\": {\n        \"id\": 28,\n        \"name\": \"Rox Chain\",\n        \"symbol\": \"ROX\",\n        \"createdAt\": \"07 September, 2025 10:04:58\",\n        \"updatedAt\": \"07 September, 2025 10:04:58\",\n        \"type\": \"PUBLIC\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n        \"isSwappable\": false,\n        \"category\": \"Solana\"\n      },\n      \"createdAt\": \"08 September, 2025 09:02:06\",\n      \"updatedAt\": \"08 September, 2025 09:02:12\",\n      \"type\": \"NFT\",\n      \"status\": \"DEPLOYED\",\n      \"verificationStatus\": \"VERIFIED\",\n      \"tokenExplorerUrl\": \"https://roxscan.roxcustody.io/address/8hPLkzE2A6AHns7aB2EFLZrkeNS39FPDo5GvVgh1ij6b\",\n      \"initialSupply\": \"1\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Client not found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft?page=1&limit=10&filters[isCollection]=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[isCollection]",
                      "value": "true"
                    }
                  ]
                }
              },
              "status": "Client not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Client not found in this vault\",\n  \"errors\": {\n    \"message\": \"Client not found in this vault\"\n},\n  \"code\": \"E03402\"\n}"
            },
            {
              "name": "Invalid Filters Error",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft?page=1&limit=10&filters[isCollection]=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[isCollection]",
                      "value": "true"
                    }
                  ]
                }
              },
              "status": "Invalid Filters Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"filters must have valid values according to type,networkId,vaultId,id,status,internalOwnerType,internalOwnerTargetId,parentId,isCollection.\",\n  \"errors\": {\n    \"message\": \"filters must have valid values according to type,networkId,vaultId,id,status,internalOwnerType,internalOwnerTargetId,parentId,isCollection.\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Transfer NFT Token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "nft",
                ":id",
                "transfer"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "NFT ID"
                }
              ]
            },
            "description": "Transfers an NFT (classic v1 flow) to another address on the same network. Returns the ID of the blockchain transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"recipientAddress\": \"8fgxN5w32YSQZvURvhx1jPM7bRQXyYosFq3fsTLKSL3z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "NFT transfer transaction has been created successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "NFT transfer transaction has been created successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"NFT transfer transaction has been created successfully\",\n  \"data\": {\n    \"transactionId\": 101\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "NFT Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "NFT Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Security token not found\",\n  \"errors\": {\n    \"message\": \"Security token not found\",\n    \"error\": \"Not Found\",\n    \"statusCode\": 404\n},\n  \"code\": \"E00403\"\n}"
            },
            {
              "name": "No Coin Asset Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "No Coin Asset Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"No coin asset found for this network\",\n  \"errors\": {\n    \"message\": \"No coin asset found for this network\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Invalid Transfer Conditions",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "Invalid Transfer Conditions",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Security token is not deployed\",\n  \"errors\": {\n    \"message\": \"Security token is not deployed\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Invalid Recipient Address",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "Invalid Recipient Address",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Invalid recipient address\",\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Vault Mismatch Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "Vault Mismatch Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Vault id does not match\",\n  \"errors\": {\n    \"message\": \"Vault id does not match\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "Validation Error",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"Error in provided data\",\n  \"errors\": {\n    \"recipientAddress\": [\"The address provided is not a valid EVM, BitCoin, BitcoinTest, Tron, Solana, Xrp, Polkadot, Stellar or RoxChain address\"]\n  },\n  \"code\": \"E00402\"\n}"
            },
            {
              "name": "Not Enough Balance For Fees",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/nft/:id/transfer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "nft",
                    ":id",
                    "transfer"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "NFT ID"
                    }
                  ]
                }
              },
              "status": "Not Enough Balance For Fees",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Not enough balance for fees\",\n  \"errors\": {\n    \"message\": \"Not enough balance for fees\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get Collection NFTs",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token/:securityTokenId/items?page=1&limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token",
                ":securityTokenId",
                "items"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "limit",
                  "value": "10"
                }
              ],
              "variable": [
                {
                  "key": "securityTokenId",
                  "value": "",
                  "description": "Collection (token) ID"
                }
              ]
            },
            "description": "Lists the individual NFTs of a collection you created (one entry per token ID), with their current holder."
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/:securityTokenId/items?page=1&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    ":securityTokenId",
                    "items"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "limit",
                      "value": "10"
                    }
                  ],
                  "variable": [
                    {
                      "key": "securityTokenId",
                      "value": "",
                      "description": "Collection (token) ID"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"NFT items\",\n  \"data\": [\n    {\n      \"assetId\": 3120,\n      \"securityTokenId\": 88,\n      \"nftTokenId\": \"1\",\n      \"holderAddress\": \"0x8C1f0b5e2a3d4c6b7e9f0a1b2c3d4e5f6a7b8c9d\",\n      \"holderWalletId\": 2322,\n      \"metadataUrl\": \"ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi/1.json\",\n      \"state\": \"MINTED\",\n      \"createdAt\": \"09 November, 2026 10:40:12\",\n      \"updatedAt\": \"09 November, 2026 10:40:12\"\n    }\n  ],\n  \"meta\": {\n    \"totalItems\": 1,\n    \"itemsPerPage\": 10,\n    \"totalPages\": 1,\n    \"currentPage\": 1,\n    \"hasPreviousPage\": false,\n    \"hasNextPage\": false\n  },\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Get Collection NFT",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/tokenization/token/:securityTokenId/items/:nftTokenId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "tokenization",
                "token",
                ":securityTokenId",
                "items",
                ":nftTokenId"
              ],
              "variable": [
                {
                  "key": "securityTokenId",
                  "value": "",
                  "description": "Collection (token) ID"
                },
                {
                  "key": "nftTokenId",
                  "value": "",
                  "description": "On-chain token ID of the NFT"
                }
              ]
            },
            "description": "Returns one NFT of a collection you created, by its on-chain token ID."
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/:securityTokenId/items/:nftTokenId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    ":securityTokenId",
                    "items",
                    ":nftTokenId"
                  ],
                  "variable": [
                    {
                      "key": "securityTokenId",
                      "value": "",
                      "description": "Collection (token) ID"
                    },
                    {
                      "key": "nftTokenId",
                      "value": "",
                      "description": "On-chain token ID of the NFT"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"NFT item\",\n  \"data\": {\n    \"assetId\": 3120,\n    \"securityTokenId\": 88,\n    \"nftTokenId\": \"1\",\n    \"holderAddress\": \"0x8C1f0b5e2a3d4c6b7e9f0a1b2c3d4e5f6a7b8c9d\",\n    \"holderWalletId\": 2322,\n    \"metadataUrl\": \"ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi/1.json\",\n    \"state\": \"MINTED\",\n    \"createdAt\": \"09 November, 2026 10:40:12\",\n    \"updatedAt\": \"09 November, 2026 10:40:12\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "NFT Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/tokenization/token/:securityTokenId/items/:nftTokenId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "tokenization",
                    "token",
                    ":securityTokenId",
                    "items",
                    ":nftTokenId"
                  ],
                  "variable": [
                    {
                      "key": "securityTokenId",
                      "value": "",
                      "description": "Collection (token) ID"
                    },
                    {
                      "key": "nftTokenId",
                      "value": "",
                      "description": "On-chain token ID of the NFT"
                    }
                  ]
                }
              },
              "status": "NFT Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"NFT 7 not found in this collection\",\n  \"errors\": {\n    \"message\": \"NFT 7 not found in this collection\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Crypto Payment Orders",
      "description": "Accept crypto payments from your customers. A payment order is an invoice in fiat (amountInFiat, in your vault's currency) that the customer pays in crypto. Available in payment vaults.\n\nFlow: 1) Create the order. 2) If you did not give an assetId, the customer picks a coin and you call Select Asset; RoxCustody then assigns a dedicated receiving wallet and calculates amountInAsset at the current price. 3) The customer pays to the wallet address, or through paymentLink, before expiration. 4) RoxCustody detects the payment and marks the order PAID; you receive the paid_payment_vault_order webhook.\n\nStatuses: INITIALIZING (being created), PENDING (waiting for payment), PAID, EXPIRED, CANCELLED, REFUNDED. Order ids: you can give your own id (up to 42 characters); otherwise a ULID is generated.",
      "item": [
        {
          "name": "Create Crypto Payment Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto"
              ]
            },
            "description": "Creates a payment order. With assetId, the receiving wallet and the crypto amount are prepared immediately; without it, call Select Crypto Payment Order Asset once the customer chooses a coin.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amountInFiat\": 100,\n  \"id\": \"order-123\",\n  \"clientName\": \"John Doe\",\n  \"itemName\": \"Product Purchase\",\n  \"assetId\": 2169,\n  \"email\": \"customer@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Payment Vault Order Created Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ]
                }
              },
              "status": "Payment Vault Order Created Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"message\":\"Payment vault order created successfully\",\"data\":{\"id\":\"order-123\",\"vaultId\":13,\"clientName\":\"JohnDoe\",\"itemName\":\"ProductPurchase\",\"status\":\"PENDING\",\"amountInDollar\":\"100\",\"amountInFiat\":100,\"email\":\"customer@example.com\",\"walletId\":32,\"wallet\":{\"id\":32,\"balance\":\"0\",\"publicAddress\":\"FCHshXgJJGF1H3G5JWnzjLuFWw39v3ViMALrxt21BrvU\",\"asset\":{\"id\":2169,\"networkId\":28,\"pricingId\":\"rox\",\"name\":\"Rox\",\"symbol\":\"ROX\",\"contractAddress\":null,\"decimals\":9,\"network\":{\"id\":28,\"name\":\"RoxChain\",\"symbol\":\"ROX\",\"createdAt\":\"23December,202514:24:14\",\"updatedAt\":\"23December,202514:24:14\",\"type\":\"PUBLIC\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\"isSwappable\":false,\"category\":\"Solana\",\"chain\":{\"id\":245022934,\"name\":\"RoxChain\",\"nativeCurrency\":{\"name\":\"Rox\",\"symbol\":\"ROX\",\"decimals\":9},\"rpcUrls\":{\"default\":{\"http\":[],\"webSocket\":[]}},\"blockExplorers\":{\"default\":{\"name\":\"Roxchainexplorer\",\"url\":\"https://explorer.roxchain.io\",\"apiUrl\":\"https://rpc.roxchain.io\"}}}},\"createdAt\":\"23December,202514:24:14\",\"updatedAt\":\"23December,202514:24:14\",\"vaultStatus\":\"active\",\"isHidden\":false,\"type\":\"COIN\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"}},\"asset\":{\"id\":2169,\"networkId\":28,\"pricingId\":\"rox\",\"name\":\"Rox\",\"symbol\":\"ROX\",\"contractAddress\":null,\"decimals\":9,\"network\":{\"id\":28,\"name\":\"RoxChain\",\"symbol\":\"ROX\",\"createdAt\":\"23December,202514:24:14\",\"updatedAt\":\"23December,202514:24:14\",\"type\":\"PUBLIC\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\"isSwappable\":false,\"category\":\"Solana\",\"chain\":{\"id\":245022934,\"name\":\"RoxChain\",\"nativeCurrency\":{\"name\":\"Rox\",\"symbol\":\"ROX\",\"decimals\":9},\"rpcUrls\":{\"default\":{\"http\":[],\"webSocket\":[]}},\"blockExplorers\":{\"default\":{\"name\":\"Roxchainexplorer\",\"url\":\"https://explorer.roxchain.io\",\"apiUrl\":\"https://rpc.roxchain.io\"}}}},\"createdAt\":\"23December,202514:24:14\",\"updatedAt\":\"23December,202514:24:14\",\"vaultStatus\":\"active\",\"isHidden\":false,\"type\":\"COIN\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"},\"createdAt\":\"2025-12-28T13:51:49.011Z\",\"updatedAt\":\"2025-12-28T13:51:49.011Z\",\"balance\":\"0\",\"paymentLink\":\"roxcustody.com/orders/01KDJTH8FTDXBERQ6DQSAN3F48\",\"globalId\":\"01KDJTH8FTDXBERQ6DQSAN3F48\",\"amountInAsset\":\"100\",\"expiration\":\"2026-02-18T12:53:47.990Z\"},\"status\":201}"
            },
            {
              "name": "Order ID Already Exists",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ]
                }
              },
              "status": "Order ID Already Exists",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":400,\"message\":\"order number already exists\",\"errors\":{\"message\":\"order number already exists\"},\"code\":\"E08403\"}"
            },
            {
              "name": "Asset Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ]
                }
              },
              "status": "Asset Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Asset not found\",\n  \"errors\": {\n    \"message\": \"Asset not found\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Wallet not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ]
                }
              },
              "status": "Wallet not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Wallet not found\",\"errors\":{\"message\":\"Wallet not found\"},\"code\":\"E04401\"}"
            },
            {
              "name": "Amount Out Of Range",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ]
                }
              },
              "status": "Amount Out Of Range",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 422,\n  \"message\": \"amountInFiat must be greater than or equal to 1\",\n  \"errors\": {\n    \"message\": \"amountInFiat must be greater than or equal to 1\"\n  },\n  \"code\": \"E00402\"\n}"
            }
          ]
        },
        {
          "name": "Select Crypto Payment Order Asset",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto",
                "select-asset"
              ]
            },
            "description": "Sets the coin a PENDING order will be paid in. RoxCustody assigns a receiving wallet on that network and calculates amountInAsset at the current price. You can call it again to switch to another asset while the order is PENDING.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"orderId\": \"order-123\",\n  \"assetId\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Asset Selected Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Asset Selected Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Payment vault order asset selected successfully\",\n  \"data\": {\n    \"id\": \"order-123\",\n    \"vaultId\": 13,\n    \"walletId\": 34,\n    \"clientName\": \"John Doe\",\n    \"itemName\": \"Product Purchase\",\n    \"status\": \"PENDING\",\n    \"amountInDollar\": \"100.00000000000000000000\",\n    \"amountInFiat\": \"100.00000000000000000000\",\n    \"email\": \"customer@example.com\",\n    \"expiration\": \"2025-12-28T17:26:57.000Z\",\n    \"vault\": {\n      \"gasStationCategoryId\": 1,\n      \"fiatCurrencyDetails\": {\n        \"id\": 5,\n        \"name\": \"US Dollar\",\n        \"symbol\": \"$\",\n        \"pricingId\": \"usd\"\n      },\n      \"photo\": null\n    },\n    \"wallet\": {\n      \"id\": 34,\n      \"assetId\": 13,\n      \"balance\": \"0\",\n      \"pendingBalance\": \"0\",\n      \"publicAddress\": \"0x8159f7C943B070C1a0c51E0a70ad86BaE08b9f2d\",\n      \"transactionsCount\": \"0\",\n      \"targetId\": \"5\",\n      \"protocol\": 0,\n      \"asset\": {\n        \"id\": 1,\n        \"networkId\": 1,\n        \"pricingId\": \"ethereum\",\n        \"name\": \"Ether\",\n        \"symbol\": \"ETH\",\n        \"contractAddress\": null,\n        \"decimals\": 18,\n        \"network\": {\n          \"id\": 1,\n          \"name\": \"Ethereum\",\n          \"symbol\": \"ETH\",\n          \"createdAt\": \"23 December, 2025 14:24:13\",\n          \"updatedAt\": \"23 December, 2025 14:24:13\",\n          \"type\": \"PUBLIC\",\n          \"status\": \"ACTIVE\",\n          \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/ethereum.png\",\n          \"isSwappable\": true,\n          \"category\": \"EVM\",\n          \"chain\": {\n            \"id\": 1,\n            \"name\": \"Ethereum\",\n            \"nativeCurrency\": {\n              \"name\": \"Ether\",\n              \"symbol\": \"ETH\",\n              \"decimals\": 18\n            },\n            \"rpcUrls\": {\n              \"default\": {\n                \"http\": [\n                  \"https://ethereum-rpc.publicnode.com\",\n                  \"https://eth.llamarpc.com\"\n                ]\n              }\n            },\n            \"blockExplorers\": {\n              \"default\": {\n                \"name\": \"Etherscan\",\n                \"url\": \"https://etherscan.io\",\n                \"apiUrl\": \"https://api.etherscan.io/api\"\n              }\n            }\n          }\n        },\n        \"createdAt\": \"23 December, 2025 14:24:14\",\n        \"updatedAt\": \"24 December, 2025 11:32:51\",\n        \"type\": \"COIN\",\n        \"status\": \"ACTIVE\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/ethereum.png\"\n      },\n      \"createdAt\": \"28 December, 2025 16:26:56\",\n      \"updatedAt\": \"28 December, 2025 16:26:56\",\n      \"type\": \"ORDER\"\n    },\n    \"amountToBeCollected\": \"0\",\n    \"createdAt\": \"2025-12-28T13:51:49.011Z\",\n    \"updatedAt\": \"2025-12-28T14:26:56.000Z\",\n    \"transactions\": [],\n    \"balance\": \"0\",\n    \"expirationWithTolerance\": \"2025-12-28T17:26:57.000Z\",\n    \"paymentLink\": \"roxcustody.com/orders/01KDJTH8FTDXBERQ6DQSAN3F48\",\n    \"globalId\": \"01KDJTH8FTDXBERQ6DQSAN3F48\",\n    \"amountInAsset\": \"0.033965083893757218\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Order not found\",\"errors\":{\"message\":\"Order not found\"},\"code\":\"E08404\"}"
            },
            {
              "name": "Asset Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Asset Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Asset not found\",\n  \"errors\": {\n    \"message\": \"Asset not found\"\n},\n  \"code\": \"E06402\"\n}"
            },
            {
              "name": "Order Not Pending",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Order Not Pending",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":400,\"message\":\"Order is not pending\",\"errors\":{\"message\":\"Order is not pending\"},\"code\":\"E08402\"}"
            },
            {
              "name": "Order already has this asset",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Order already has this asset",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Order already has this asset\",\n  \"errors\": {\n    \"message\": \"Order already has this asset\"\n  },\n  \"code\": \"E08401\"\n}"
            },
            {
              "name": "Cannot Change Asset",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Cannot Change Asset",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":400,\"message\":\"You cannot change the asset of this order\",\"errors\":{\"message\":\"You cannot change the asset of this order\",\"error\":\"Bad Request\",\"statusCode\":400},\"code\":\"E00401\"}"
            },
            {
              "name": "Wallet not found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/select-asset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    "select-asset"
                  ]
                }
              },
              "status": "Wallet not found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Wallet not found\",\"errors\":{\"message\":\"Wallet not found\"},\"code\":\"E04401\"}"
            }
          ]
        },
        {
          "name": "Get Crypto Payment Orders",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto?limit=10&filters[status]=PAID",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[status]",
                  "value": "PAID"
                }
              ]
            },
            "description": "Lists this vault's crypto payment orders, newest first by default."
          },
          "response": [
            {
              "name": "Orders Retrieved Successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto?limit=10&filters[status]=PAID",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[status]",
                      "value": "PAID"
                    }
                  ]
                }
              },
              "status": "Orders Retrieved Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Payment vault orders fetched successfully\",\n  \"data\": [\n    {\n      \"id\": \"order-123\",\n      \"vaultId\": 1,\n      \"status\": \"PENDING\",\n      \"amountInDollar\": \"100.00\",\n      \"amountInFiat\": \"100.00\",\n      \"amountInAsset\": \"0.05\",\n      \"clientName\": \"John Doe\",\n      \"itemName\": \"Product Purchase\",\n      \"email\": \"customer@example.com\",\n      \"expiration\": \"2025-12-28T12:57:25.000Z\",\n      \"balance\": \"0\",\n      \"globalId\": \"01JGXYZ123ABC456DEF789GHI\",\n      \"paymentLink\": \"https://rox.com/orders/01JGXYZ123ABC456DEF789GHI\",\n      \"amountToBeCollected\": \"0\",\n      \"wallet\": {\n        \"id\": 123,\n        \"publicAddress\": \"0x1234567890abcdef1234567890abcdef12345678\",\n        \"decimals\": 18,\n        \"balance\": \"0\",\n        \"asset\": {\n          \"id\": 1,\n          \"name\": \"Ether\",\n          \"symbol\": \"ETH\",\n          \"network\": {\n            \"id\": 1,\n            \"name\": \"Ethereum\",\n            \"symbol\": \"ETH\",\n            \"category\": \"EVM\"\n          }\n        }\n      },\n      \"transactions\": [],\n      \"createdAt\": \"2025-12-28T11:57:25.000Z\",\n      \"updatedAt\": \"2025-12-28T11:57:25.000Z\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Get Crypto Payment Order Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The ID of the payment order to retrieve"
                }
              ]
            },
            "description": "Returns one payment order with its receiving wallet, amounts, balance received and blockchain transactions."
          },
          "response": [
            {
              "name": "Payment vault order fetched successfully",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to retrieve"
                    }
                  ]
                }
              },
              "status": "Payment vault order fetched successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"message\":\"Payment vault order fetched successfully\",\"data\":{\"id\":\"order-123\",\"vaultId\":13,\"clientName\":\"John Doe\",\"itemName\":\"Product Purchase\",\"status\":\"PAID\",\"amountInDollar\":\"100.00000000000000000000\",\"amountInFiat\":\"100.00000000000000000000\",\"email\":\"customer@example.com\",\"expiration\":\"2025-12-28T17:26:57.000Z\",\"walletId\":\"order-123\",\"vault\":{\"id\":1,\"name\":\"Test Vault\",\"fiatCurrency\":{\"id\":5,\"name\":\"US Dollar\",\"symbol\":\"$\",\"pricingId\":\"usd\"}},\"wallet\":{\"id\":34,\"balance\":\"0\",\"pendingBalance\":\"0\",\"publicAddress\":\"0x8159f7C943B070C1a0c51E0a70ad86BaE08b9f2d\",\"transactionsCount\":\"0\",\"targetId\":\"5\",\"protocol\":0,\"asset\":{\"id\":1, \"networkId\":1,\"pricingId\":\"ethereum\",\"name\":\"Ether\",\"symbol\":\"ETH\",\"contractAddress\":null,\"decimals\":18,\"network\":{\"id\":1,\"name\":\"Ethereum\",\"symbol\":\"ETH\",\"createdAt\":\"23 December, 2025 14:24:13\",\"updatedAt\":\"23 December, 2025 14:24:13\",\"type\":\"PUBLIC\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/ethereum.png\",\"isSwappable\":true,\"category\":\"EVM\",\"chain\":{\"id\":1,\"name\":\"Ethereum\",\"nativeCurrency\":{\"name\":\"Ether\",\"symbol\":\"ETH\",\"decimals\":18},\"rpcUrls\":{\"default\":{\"http\":[\"https://ethereum-rpc.publicnode.com\",\"https://eth.llamarpc.com\"]}},\"blockExplorers\":{\"default\":{\"name\":\"Etherscan\",\"url\":\"https://etherscan.io\",\"apiUrl\":\"https://api.etherscan.io/api\"}}}},\"createdAt\":\"23 December, 2025 14:24:14\",\"updatedAt\":\"24 December, 2025 11:32:51\",\"type\":\"COIN\",\"status\":\"ACTIVE\",\"logo\":\"https://api-admin.roxcustody.io/public/files/assets/ethereum.png\"},\"createdAt\":\"28 December, 2025 16:26:56\",\"updatedAt\":\"28 December, 2025 16:26:56\",\"type\":\"ORDER\"},\"amountToBeCollected\":\"0\",\"createdAt\":\"2025-12-28T13:51:49.011Z\",\"updatedAt\":\"2025-12-28T14:37:35.168Z\",\"transactions\":[],\"balance\":\"0\",\"expirationWithTolerance\":\"2025-12-28T17:26:57.000Z\",\"paymentLink\":\"roxcustody.com/orders/01KDJTH8FTDXBERQ6DQSAN3F48\",\"globalId\":\"01KDJTH8FTDXBERQ6DQSAN3F48\",\"amountInAsset\":\"0.033965083893757218\"},\"status\":200}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to retrieve"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Order not found\",\"errors\":{\"message\":\"Order not found\"},\"code\":\"E08404\"}"
            }
          ]
        },
        {
          "name": "Cancel Crypto Payment Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto",
                ":orderId",
                "cancel"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The ID of the payment order to cancel"
                }
              ]
            },
            "description": "Cancels a PENDING order. An order that already received a payment cannot be cancelled."
          },
          "response": [
            {
              "name": "Order Cancelled Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Cancelled Successfully",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Payment vault order cancelled successfully\",\n  \"status\": 200\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":404,\"message\":\"Order not found\",\"errors\":{\"message\":\"Order not found\"},\"code\":\"E08404\"}"
            },
            {
              "name": "Order Has Transactions",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Has Transactions",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Cannot cancel order with transactions\",\n  \"errors\": {\n    \"message\": \"Cannot cancel order with transactions\"\n  },\n  \"code\": \"E08601\"\n}"
            },
            {
              "name": "Order Not Pending",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Not Pending",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\"status\":400,\"message\":\"Order is not pending\",\"errors\":{\"message\":\"Order is not pending\"},\"code\":\"E08402\"}"
            }
          ]
        },
        {
          "name": "Update Crypto Payment Order",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "crypto",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The ID of the crypto payment order to update"
                }
              ]
            },
            "description": "Changes the clientName and/or itemName of an order. Send at least one of them.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"clientName\": \"John Doe\",\n  \"itemName\": \"Updated Consulting Service\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Payment Vault Order Updated",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the crypto payment order to update"
                    }
                  ]
                }
              },
              "status": "Payment Vault Order Updated",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Payment vault order updated successfully\",\n  \"data\": {},\n  \"status\": 200\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/crypto/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "crypto",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The ID of the crypto payment order to update"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Payment vault order not found\",\n  \"errors\": {\n    \"message\": \"Payment vault order not found\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Fiat Payment Orders",
      "description": "Accept bank and card payments in fiat (currently SAR). Available in fiat payment vaults.\n\nFlow: create the order; RoxCustody opens a dedicated virtual account for it and returns a hosted checkout link (paymentLink). Send the customer to that link. When the payment arrives, the order becomes PAID and you receive the fiat_payment_vault_order_paid webhook. If you stored the customer's IBAN, the order can be refunded (REFUNDED, webhook fiat_payment_vault_order_refunded).\n\nStatuses: INITIALIZING, PENDING, PAID, EXPIRED, CANCELLED, REFUNDED.",
      "item": [
        {
          "name": "Create Fiat Payment Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/fiat",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "fiat"
              ]
            },
            "description": "Creates a fiat payment order and its checkout link. Give the customer's IBAN if you may need to refund them, and returnUrl to bring them back to your site after paying.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amountInFiat\": 100,\n  \"clientName\": \"John Doe\",\n  \"currencyCode\": \"SAR\",\n  \"IBAN\": \"SA0380000000608010167519\",\n  \"returnUrl\": \"https://example.com/checkout/complete\",\n  \"id\": \"fiat-order-123\",\n  \"itemName\": \"Service Subscription\",\n  \"email\": \"customer@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Fiat Payment Order Created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat"
                  ]
                }
              },
              "status": "Fiat Payment Order Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat payment vault order created successfully\",\n  \"data\": {\n    \"id\": \"fiat-order-12q3\",\n    \"vaultId\": 47,\n    \"clientName\": \"John Doe\",\n    \"itemName\": \"Service Subscription\",\n    \"amountInDollar\": \"26.666666666666666667\",\n    \"amountInFiat\": \"100\",\n    \"email\": \"customer@example.com\",\n    \"expiration\": \"2026-10-25T15:54:19.867Z\",\n    \"IBAN\": \"SA0380000000608010167519\",\n    \"fiatAccountId\": \"40\",\n    \"fiatAccount\": {\n      \"type\": 2,\n      \"targetId\": 336,\n      \"vaultId\": 47,\n      \"currencyId\": 1,\n      \"provider\": 1,\n      \"currencyCode\": \"SAR\",\n      \"providerData\": {},\n      \"id\": \"40\",\n      \"createdAt\": \"2026-10-25T14:54:19.872Z\",\n      \"updatedAt\": \"2026-10-25T14:54:19.872Z\",\n      \"totalDeposits\": \"0\",\n      \"totalRefunds\": \"0\",\n      \"status\": 1\n    },\n    \"paymentLink\": \"https://dhamendemo.elm.sa/pay1/6defa7e51877a671b65fdde7e102d5a386dd7e27bee97c0f8bbaefee1cb3b538\",\n    \"createdAt\": \"25 October, 2026 17:54:19\",\n    \"updatedAt\": \"25 October, 2026 17:54:19\",\n    \"globalId\": \"01M5SRWB6QGN5T1FF1BRJ7KY48\",\n    \"status\": \"PENDING\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Validation Error",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat"
                  ]
                }
              },
              "status": "Validation Error",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"No active fiat currency configured for this vault\",\n  \"errors\": {\n    \"message\": \"No active fiat currency configured for this vault\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get Fiat Payment Orders",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/fiat?limit=10&filters[status]=PAID",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "fiat"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "10"
                },
                {
                  "key": "filters[status]",
                  "value": "PAID"
                }
              ]
            },
            "description": "Lists this vault's fiat payment orders, newest first by default."
          },
          "response": [
            {
              "name": "Fiat Payment Orders Fetched",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat?limit=10&filters[status]=PAID",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "10"
                    },
                    {
                      "key": "filters[status]",
                      "value": "PAID"
                    }
                  ]
                }
              },
              "status": "Fiat Payment Orders Fetched",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat payment vault orders fetched successfully\",\n  \"data\": [\n    {\n      \"id\": \"fiat-order-12q3\",\n      \"vaultId\": 47,\n      \"clientName\": \"John Doe\",\n      \"itemName\": \"Service Subscription\",\n      \"amountInDollar\": \"26.666666666666666667\",\n      \"amountInFiat\": \"100\",\n      \"email\": \"customer@example.com\",\n      \"expiration\": \"2026-10-25T15:54:19.867Z\",\n      \"IBAN\": \"SA0380000000608010167519\",\n      \"fiatAccountId\": \"40\",\n      \"fiatAccount\": {\n        \"type\": 2,\n        \"targetId\": 336,\n        \"vaultId\": 47,\n        \"currencyId\": 1,\n        \"provider\": 1,\n        \"currencyCode\": \"SAR\",\n        \"providerData\": {},\n        \"id\": \"40\",\n        \"createdAt\": \"2026-10-25T14:54:19.872Z\",\n        \"updatedAt\": \"2026-10-25T14:54:19.872Z\",\n        \"totalDeposits\": \"0\",\n        \"totalRefunds\": \"0\",\n        \"status\": 1\n      },\n      \"paymentLink\": \"https://dhamendemo.elm.sa/pay1/6defa7e51877a671b65fdde7e102d5a386dd7e27bee97c0f8bbaefee1cb3b538\",\n      \"createdAt\": \"25 October, 2026 17:54:19\",\n      \"updatedAt\": \"25 October, 2026 17:54:19\",\n      \"globalId\": \"01M5SRWB6QGN5T1FF1BRJ7KY48\",\n      \"status\": \"PENDING\"\n    }\n  ],\n  \"meta\": {\n    \"hasNextPage\": false,\n    \"hasPreviousPage\": false,\n    \"nextCursor\": null,\n    \"previousCursor\": null,\n    \"limit\": 10\n  },\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Get Fiat Payment Order Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "fiat",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The unique ID of the fiat payment order to retrieve"
                }
              ]
            },
            "description": "Returns one fiat payment order with its checkout link and status."
          },
          "response": [
            {
              "name": "Fiat Payment Order Fetched",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to retrieve"
                    }
                  ]
                }
              },
              "status": "Fiat Payment Order Fetched",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat payment vault order fetched successfully\",\n  \"data\": {\n    \"id\": \"fiat-order-12q3\",\n    \"vaultId\": 47,\n    \"clientName\": \"John Doe\",\n    \"itemName\": \"Service Subscription\",\n    \"amountInDollar\": \"26.666666666666666667\",\n    \"amountInFiat\": \"100\",\n    \"email\": \"customer@example.com\",\n    \"expiration\": \"2026-10-25T15:54:19.867Z\",\n    \"IBAN\": \"SA0380000000608010167519\",\n    \"fiatAccountId\": \"40\",\n    \"fiatAccount\": {\n      \"type\": 2,\n      \"targetId\": 336,\n      \"vaultId\": 47,\n      \"currencyId\": 1,\n      \"provider\": 1,\n      \"currencyCode\": \"SAR\",\n      \"providerData\": {},\n      \"id\": \"40\",\n      \"createdAt\": \"2026-10-25T14:54:19.872Z\",\n      \"updatedAt\": \"2026-10-25T14:54:19.872Z\",\n      \"totalDeposits\": \"0\",\n      \"totalRefunds\": \"0\",\n      \"status\": 1\n    },\n    \"paymentLink\": \"https://dhamendemo.elm.sa/pay1/6defa7e51877a671b65fdde7e102d5a386dd7e27bee97c0f8bbaefee1cb3b538\",\n    \"createdAt\": \"25 October, 2026 17:54:19\",\n    \"updatedAt\": \"25 October, 2026 17:54:19\",\n    \"globalId\": \"01M5SRWB6QGN5T1FF1BRJ7KY48\",\n    \"status\": \"PENDING\"\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to retrieve"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Fiat payment order not found\",\n  \"errors\": {\n    \"message\": \"Fiat payment order not found\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        },
        {
          "name": "Cancel Fiat Payment Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "fiat",
                ":orderId",
                "cancel"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The unique ID of the fiat payment order to cancel"
                }
              ]
            },
            "description": "Cancels a PENDING fiat payment order."
          },
          "response": [
            {
              "name": "Fiat Payment Order Cancelled",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Fiat Payment Order Cancelled",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat payment vault order cancelled successfully\",\n  \"data\": {},\n  \"status\": 200\n}"
            },
            {
              "name": "Order Not Pending",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Not Pending",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Order could not be cancelled because its status has already changed.\",\n  \"errors\": {\n    \"message\": \"Order could not be cancelled because its status has already changed.\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to cancel"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Fiat payment order not found\",\n  \"errors\": {\n    \"message\": \"Fiat payment order not found\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        },
        {
          "name": "Update Fiat Payment Order",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "payment-orders",
                "fiat",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "",
                  "description": "The unique ID of the fiat payment order to update"
                }
              ]
            },
            "description": "Changes the itemName of a fiat payment order.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"itemName\": \"Updated Consulting Package\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Fiat Payment Order Updated",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to update"
                    }
                  ]
                }
              },
              "status": "Fiat Payment Order Updated",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat payment vault order updated successfully\",\n  \"data\": {},\n  \"status\": 200\n}"
            },
            {
              "name": "Order Not Found",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/payment-orders/fiat/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "payment-orders",
                    "fiat",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "The unique ID of the fiat payment order to update"
                    }
                  ]
                }
              },
              "status": "Order Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Payment vault order not found\",\n  \"errors\": {\n    \"message\": \"Payment vault order not found\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Fiat Gateway",
      "description": "Fiat operations for fiat vaults: let a client deposit money with a payment link, look up fiat accounts and transactions, refund deposits, and pay out your collected balance to your company bank account.\n\nEach fiat client has a fiat account (a virtual IBAN, VIBAN). Deposits create fiat transactions (type DEPOSIT); refunds and payouts create transactions of type REFUND and PAYOUT. Transaction statuses: PENDING, PROCESSING, SUCCESS, FAILED. Follow them with the fiat_transaction_created, fiat_transaction_completed, fiat_transaction_failed and fiat_refund_created webhooks.\n\nCurrency: currently SAR only.",
      "item": [
        {
          "name": "Generate Payment Link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat-payments/payment-link/client",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat-payments",
                "payment-link",
                "client"
              ]
            },
            "description": "Creates a hosted payment page where one of your fiat clients can deposit money (card or bank transfer). The client must have a name.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"clientId\": \"client123\",\n  \"amount\": 376.88,\n  \"currencyCode\": \"SAR\",\n  \"IBAN\": \"SA1234567890\",\n  \"returnUrl\": \"https://example.com/callback\",\n  \"paymentExpiredInMinutes\": 60\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Payment Link Generated Successfully",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-payments/payment-link/client",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-payments",
                    "payment-link",
                    "client"
                  ]
                }
              },
              "status": "Payment Link Generated Successfully",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Payment link generated successfully.\",\n  \"data\": {\n    \"paymentLink\": \"\",\n    \"url\": \"https://dhamendemo.elm.sa/pay1/c8fd935c881953e91422bdc0033da12627f9e9142a0eef46e04688ccb9b93893\"\n    }\n}"
            },
            {
              "name": "Client Not Found",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-payments/payment-link/client",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-payments",
                    "payment-link",
                    "client"
                  ]
                }
              },
              "status": "Client Not Found",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Client customer-2001 not found\",\n  \"errors\": {\n    \"message\": \"Client customer-2001 not found\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Client Missing Name",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-payments/payment-link/client",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-payments",
                    "payment-link",
                    "client"
                  ]
                }
              },
              "status": "Client Missing Name",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Client customer-2001 is missing name\",\n  \"errors\": {\n    \"message\": \"Client customer-2001 is missing name\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        },
        {
          "name": "Get Fiat Transaction Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat-transactions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat-transactions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Fiat transaction ID"
                }
              ]
            },
            "description": "Returns one fiat transaction: type, status, amount, fees, bank references and processing date."
          },
          "response": [
            {
              "name": "Fiat Transaction Details",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Fiat transaction ID"
                    }
                  ]
                }
              },
              "status": "Fiat Transaction Details",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat Transaction Details.\",\n  \"data\": {\n    \"id\": \"59\",\n    \"fiatAccountId\": \"31\",\n    \"parentId\": \"58\",\n    \"vaultId\": 23,\n    \"currencyCode\": \"SAR\",\n    \"rrn\": null,\n    \"externalTransactionId\": \"ref_31_57237e9438048809\",\n    \"processedAt\": \"2026-06-15T08:54:44.000Z\",\n    \"fiatAccount\": {\n      \"id\": \"31\",\n      \"targetId\": \"31\",\n      \"vaultId\": 23,\n      \"currencyCode\": \"SAR\",\n      \"VIBAN\": null,\n      \"currency\": {\n        \"id\": 1,\n        \"code\": \"SAR\",\n        \"name\": \"Saudi Riyal\",\n        \"createdAt\": \"20 May, 2026 11:44:29\",\n        \"updatedAt\": \"01 June, 2026 11:37:43\",\n        \"status\": \"ACTIVE\"\n      },\n      \"createdAt\": \"04 June, 2026 11:11:32\",\n      \"updatedAt\": \"15 June, 2026 08:54:30\",\n      \"totalDeposits\": \"636\",\n      \"totalRefunds\": \"45.49\",\n      \"type\": \"CLIENT\",\n      \"status\": \"ACTIVE\"\n    },\n    \"createdAt\": \"15 June, 2026 08:54:30\",\n    \"updatedAt\": \"15 June, 2026 08:55:04\",\n    \"type\": \"REFUND\",\n    \"status\": \"SUCCESS\",\n    \"amount\": \"9.91\",\n    \"fees\": \"0\",\n    \"isRefundable\": false\n  },\n  \"status\": 200\n}"
            },
            {
              "name": "Fiat Transaction Not Found",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Fiat transaction ID"
                    }
                  ]
                }
              },
              "status": "Fiat Transaction Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 404,\n  \"message\": \"Fiat transaction with ID 123 not found.\",\n  \"errors\": {\n    \"message\": \"Fiat transaction with ID 123 not found.\"\n  },\n  \"code\": \"E00403\"\n}"
            }
          ]
        },
        {
          "name": "Get Fiat Account Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat-accounts/:accountId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat-accounts",
                ":accountId"
              ],
              "variable": [
                {
                  "key": "accountId",
                  "value": "",
                  "description": "Fiat account ID"
                }
              ]
            },
            "description": "Returns one fiat account of this vault: its VIBAN, currency, status, owner and totals."
          },
          "response": [
            {
              "name": "Fiat Account Details",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-accounts/:accountId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-accounts",
                    ":accountId"
                  ],
                  "variable": [
                    {
                      "key": "accountId",
                      "value": "",
                      "description": "Fiat account ID"
                    }
                  ]
                }
              },
              "status": "Fiat Account Details",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Fiat Account Details.\",\n  \"data\": {\n    \"id\": 31,\n    \"targetId\": 31,\n    \"vaultId\": 23,\n    \"currencyCode\": \"SAR\",\n    \"VIBAN\": null,\n    \"currency\": {\n      \"id\": 1,\n      \"code\": \"SAR\",\n      \"name\": \"Saudi Riyal\",\n      \"createdAt\": \"20 May, 2026 11:44:29\",\n      \"updatedAt\": \"01 June, 2026 11:37:43\",\n      \"status\": \"ACTIVE\"\n    },\n    \"client\": {\n      \"id\": 31,\n      \"externalId\": \"F0\",\n      \"name\": \"ahmed aref\",\n      \"email\": null,\n      \"mobile\": null,\n      \"identityNumber\": \"1013191022\",\n      \"IBAN\": null,\n      \"createdAt\": \"04 June, 2026 11:11:32\",\n      \"updatedAt\": \"04 June, 2026 11:11:32\"\n    },\n    \"createdAt\": \"04 June, 2026 11:11:32\",\n    \"updatedAt\": \"15 June, 2026 08:54:30\",\n    \"totalDeposits\": \"636\",\n    \"totalRefunds\": \"45.49\",\n    \"type\": \"CLIENT\",\n    \"status\": \"ACTIVE\"\n  },\n  \"status\": 200\n}"
            }
          ]
        },
        {
          "name": "Refund Fiat Transaction",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat-transactions/refund",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat-transactions",
                "refund"
              ]
            },
            "description": "Refunds a deposit, fully or partly, to the IBAN stored for the client. Only deposits from clients with an IBAN can be refunded. The refund is processed asynchronously: you get the new refund transaction id now, and the fiat_refund_created webhook."
          },
          "response": [
            {
              "name": "Accepted",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat-transactions/refund",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat-transactions",
                    "refund"
                  ]
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Refund Initiated Successfully\",\n  \"data\": { \"id\": 123 },\n  \"status\": 202\n}"
            }
          ]
        },
        {
          "name": "Get Vault Fiat Currency",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat/:currencyCode",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat",
                ":currencyCode"
              ],
              "variable": [
                {
                  "key": "currencyCode",
                  "value": "",
                  "description": "Currency code, currently SAR"
                }
              ]
            },
            "description": "Returns the vault's settings for a fiat currency."
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat/:currencyCode",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat",
                    ":currencyCode"
                  ],
                  "variable": [
                    {
                      "key": "currencyCode",
                      "value": "",
                      "description": "Currency code, currently SAR"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Currency retrieved successfully\",\n  \"data\": {}\n}"
            }
          ]
        },
        {
          "name": "Estimate Fiat Payout Fees",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat/:currencyCode/payout/estimate-fees",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat",
                ":currencyCode",
                "payout",
                "estimate-fees"
              ],
              "variable": [
                {
                  "key": "currencyCode",
                  "value": "",
                  "description": "Currency code, currently SAR"
                }
              ]
            },
            "description": "Estimates the fee of a payout of your collected balance to your company bank account."
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat/:currencyCode/payout/estimate-fees",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat",
                    ":currencyCode",
                    "payout",
                    "estimate-fees"
                  ],
                  "variable": [
                    {
                      "key": "currencyCode",
                      "value": "",
                      "description": "Currency code, currently SAR"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Estimated payout fees retrieved successfully\",\n  \"data\": { \"estimatedFees\": \"10.5\" }\n}"
            }
          ]
        },
        {
          "name": "Trigger Fiat Payout",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/fiat/:currencyCode/payout/trigger",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "fiat",
                ":currencyCode",
                "payout",
                "trigger"
              ],
              "variable": [
                {
                  "key": "currencyCode",
                  "value": "",
                  "description": "Currency code, currently SAR"
                }
              ]
            },
            "description": "Pays out your collected balance (or the given amount) to your company bank account now, instead of waiting for the automatic payout.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 100.5,\n  \"idempotencyKey\": \"unique-key-123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/fiat/:currencyCode/payout/trigger",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "fiat",
                    ":currencyCode",
                    "payout",
                    "trigger"
                  ],
                  "variable": [
                    {
                      "key": "currencyCode",
                      "value": "",
                      "description": "Currency code, currently SAR"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Manual payout triggered successfully\",\n  \"data\": {},\n  \"status\": 200\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Contract Calls",
      "description": "Call any smart contract function on an EVM network (Ethereum, Polygon, BSC, …) from a client wallet, with the transaction signed in custody. You prepare the ABI-encoded call data yourself (for example with ethers.js interface.encodeFunctionData). The call is sent from the network's coin wallet of the client, and is tracked as a transaction of type CONTRACT_CALL.",
      "item": [
        {
          "name": "Create EVM Contract Call",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-ACCESS-TOKEN",
                "value": "{{accessToken}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/integration/contract-calls/evm",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "integration",
                "contract-calls",
                "evm"
              ]
            },
            "description": "Creates a contract call. Choose the sender with walletId (a coin wallet), or clientId plus assetId (the network's coin). The call is queued with status PENDING, like a transaction."
          },
          "response": [
            {
              "name": "Created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/contract-calls/evm",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "contract-calls",
                    "evm"
                  ]
                }
              },
              "status": "Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Your contract call is pending\",\n  \"contractCall\": {\n    \"id\": \"12\",\n    \"dollarAmount\": \"0.50000000000000000000\",\n    \"fiatAmount\": \"0.50000000000000000000\",\n    \"senderAddress\": \"2ohp3pBjHLMLuKgaHZguDatFY7eUZn2XiPUCA7KgGNy9\",\n    \"receiverAddress\": \"3M2vdeWjRWddacDCdKQveFHbgrfgSa8NuEjPtFjh5WHU\",\n    \"feesPayerWalletId\": \"350292\",\n    \"data\": null,\n    \"asset\": {\n      \"id\": 2170,\n      \"name\": \"Rox\",\n      \"symbol\": \"ROX\",\n      \"network\": {\n        \"id\": 29,\n        \"name\": \"Rox Chain Devnet\",\n        \"symbol\": \"ROX\",\n        \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\",\n        \"isSwappable\": false,\n        \"chain\": {\n          \"id\": 245022935,\n          \"name\": \"Rox Chain Devnet\",\n          \"nativeCurrency\": {\n            \"name\": \"Rox\",\n            \"symbol\": \"ROX\",\n            \"decimals\": 9\n          },\n          \"rpcUrls\": {\n            \"default\": {\n              \"http\": [],\n              \"webSocket\": []\n            }\n          },\n          \"blockExplorers\": {\n            \"default\": {\n              \"name\": \"Rox chain explorer\",\n              \"url\": \"https://explorer.roxchain.io\",\n              \"apiUrl\": \"https://rpc-dev.roxchain.io\"\n            }\n          },\n          \"testnet\": true\n        },\n        \"addressFormat\": null\n      },\n      \"logo\": \"https://api-admin.roxcustody.io/public/files/assets/rox.svg\"\n    },\n    \"createdAt\": \"24 March, 2026 19:29:21\",\n    \"updatedAt\": \"24 March, 2026 19:29:27\",\n    \"blockExplorerUrl\": \"https://explorer.roxchain.io/tx/85299572755017334673545733533775374353542573657?cluster=devnet\",\n    \"markup\": \"0 ROX\",\n    \"approvals\": [],\n    \"type\": \"CONTRACT_CALL\",\n    \"transactionHash\": \"85299572755017334673545733533775374353542573657\",\n    \"status\": \"PENDING\",\n    \"coinSymbol\": \"ROX\",\n    \"paymentPolicyType\": null,\n    \"amount\": \"0.5\",\n    \"fees\": \"0.0001\"\n  },\n  \"status\": 201\n}"
            },
            {
              "name": "Missing Sender",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/contract-calls/evm",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "contract-calls",
                    "evm"
                  ]
                }
              },
              "status": "Missing Sender",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Both clientId and assetId must be provided when walletId is not provided\",\n  \"errors\": {\n    \"message\": \"Both clientId and assetId must be provided when walletId is not provided\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Not A Coin Wallet",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/contract-calls/evm",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "contract-calls",
                    "evm"
                  ]
                }
              },
              "status": "Not A Coin Wallet",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Contract calls must be created using the network's native asset (coin) wallet.\",\n  \"errors\": {\n    \"message\": \"Contract calls must be created using the network's native asset (coin) wallet.\"\n  },\n  \"code\": \"E00401\"\n}"
            },
            {
              "name": "Vault Type Not Allowed",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-ACCESS-TOKEN",
                    "value": "{{accessToken}}",
                    "type": "text"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/integration/contract-calls/evm",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "integration",
                    "contract-calls",
                    "evm"
                  ]
                }
              },
              "status": "Vault Type Not Allowed",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"status\": 400,\n  \"message\": \"Contract calls are not allowed for this vault type\",\n  \"errors\": {\n    \"message\": \"Contract calls are not allowed for this vault type\"\n  },\n  \"code\": \"E00401\"\n}"
            }
          ]
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://YOUR-SUBDOMAIN.api-sandbox.roxcustody.com/api",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "YOUR-API-KEY",
      "type": "string"
    },
    {
      "key": "accessToken",
      "value": "",
      "type": "string"
    },
    {
      "key": "refreshToken",
      "value": "",
      "type": "string"
    }
  ]
}
