Clients

Create One Client Wallets

Creates a new client linked to this vault and creates new wallets for each of the integrated blockchains.

Body Parameters
id

string

requiredmax(255)

Client ID

BODY
{
  "id": "client123"
}

Responses

201

Client Created Successfully
message

string

Success message

client

object

Created client details

Show child parameters
external_id

string

External client ID (Your system ID) provided in your request

id

number

Internal client ID (Our system ID)

created_at

string

Client creation timestamp

updated_at

string

Client last updated timestamp

status

number

HTTP status code

201 RESPONSE
{
  "message": "Client created successfully.",
  "client": {
    "external_id": "client123",
    "id": 4,
    "created_at": "20 August, 2025 11:18:53",
    "updated_at": "20 August, 2025 11:18:53"
  },
  "status": 201
}

422

Client ID Already Exists
message

string

Error message

errors

object

Validation errors

Show child parameters
id

string

Error message for id field

status

number

HTTP status code

code

string

Error code

422 RESPONSE
{
  "status": 422,
  "message": "Unprocessable Entity Exception",
  "errors": {
    "id": "Clients with these IDs client123 already exist!"
  },
  "code": "E50001"
}

422

Validation Error
message

string

Error message

errors

object

Validation errors

Show child parameters
message

string

Error message

id

array

Array of error messages for id field

status

number

HTTP status code

code

string

Error code

422 RESPONSE
{
  "status": 422,
  "message": "id must be a string",
  "errors": {
    "message": "id must be a string",
    "id": [
      "id must be a string",
      "The value must not exceed 255 characters",
      "The id field is required."
    ]
  },
  "code": "E50001"
}

Create Clients Wallets

Creates multiple clients at once linked to this vault and creates new wallets for each of the integrated blockchains.

Body Parameters
ids

array

requiredeach max(255)

Array of client IDs

Show child parameters
id

string

Individual client ID

BODY
{
  "ids": [
    "client1",
    "client2",
    "client3",
    "client4",
    "client5"
  ]
}

Responses

201

Clients Created Successfully
message

string

Success message

clients

array

Array of created client details

Show child parameters
external_id

string

External client ID provided in request

id

number

Internal client ID

created_at

string

Client creation timestamp

updated_at

string

Client last updated timestamp

status

number

HTTP status code

201 RESPONSE
{
  "message": "Clients created successfully.",
  "clients": [
    {
      "external_id": "client1",
      "id": 9,
      "created_at": "20 August, 2025 11:51:20",
      "updated_at": "20 August, 2025 11:51:20"
    },
    {
      "external_id": "client2",
      "id": 10,
      "created_at": "20 August, 2025 11:51:20",
      "updated_at": "20 August, 2025 11:51:20"
    },
    {
      "external_id": "client3",
      "id": 11,
      "created_at": "20 August, 2025 11:51:20",
      "updated_at": "20 August, 2025 11:51:20"
    },
    {
      "external_id": "client4",
      "id": 12,
      "created_at": "20 August, 2025 11:51:20",
      "updated_at": "20 August, 2025 11:51:20"
    },
    {
      "external_id": "client5",
      "id": 13,
      "created_at": "20 August, 2025 11:51:20",
      "updated_at": "20 August, 2025 11:51:20"
    }
  ],
  "status": 201
}

422

Some Client IDs Already Exist
message

string

Error message

errors

object

Validation errors

Show child parameters
id

string

Error message for id field

status

number

HTTP status code

code

string

Error code

422 RESPONSE
{
  "status": 422,
  "message": "Unprocessable Entity Exception",
  "errors": {
    "id": "Clients with these IDs client1, client2, client3, client4, client5 already exist!"
  },
  "code": "E50001"
}

422

Validation Error
message

string

Error message

errors

object

Validation errors

Show child parameters
message

string

Error message

ids

array

Array of validation error messages for ids field

status

number

HTTP status code

code

string

Error code

422 RESPONSE
{
  "status": 422,
  "message": "Each value must not exceed 255 characters",
  "errors": {
    "message": "Each value must not exceed 255 characters",
    "ids": [
      "Each value must not exceed 255 characters",
      "each value in ids must be a string",
      "The ids field is required.",
      "ids must not be empty",
      "ids must be an array"
    ]
  },
  "code": "E50001"
}