Account APIs (1.0.0)

Download OpenAPI specification:

CreateStaffUser

CreateStaffUser

Endpoint used to create staff User.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
email
required
string <email>
white-label
required
string [ 5 .. 100 ] characters

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "white-label": "string"
}

Response samples

Content type
application/json
{
  • "message": "Invite sent to the user's email address."
}

Login

Login

Endpoint is used for login

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
username
required
string
password
required
string >= 8 characters
white-label
required
string [ 2 .. 100 ] characters

Responses

Request samples

Content type
application/json
{
  • "username": "user@example.com",
  • "password": "Password123",
  • "white-label": "client-app"
}

Response samples

Content type
application/json
{
  • "message": "Successful Login"
}

ChangePassword

ChangePassword

Endpoint used to change password.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
username
required
string
currentPassword
required
string [ 8 .. 15 ] characters
newPassword
required
string [ 12 .. 15 ] characters ^(?=.*[A-Z].*[A-Z])(?=.*[!@#$&*].*[!@#$&*])(?...
white-label
required
string <uri-template> [ 2 .. 100 ] characters

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{ }

CreateWalletUser

CreateWalletUser

Endpoint used to create wallet user.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
birthdate
required
string <date>
country
required
string
Enum: "Chad" "Estonia" "Ethiopia" "Falkland Islands (Malvinas)" "Faroe Islands" "Fiji" "Finland" "France" "French Guiana" "French Polynesia" "French Southern Territories" "Gabon" "Gambia" "Georgia" "Germany" "Ghana" "Gibraltar" "Greece" "Greenland" "Grenada" "Guadeloupe" "Guam" "Guatemala" "Guernsey" "Guinea" "Guinea-Bissau" "Guyana" "Haiti" "Heard and Mcdonald Islands" "Holy See (Vatican City State)" "Honduras" "Hungary" "Iceland" "India" "Indonesia" "Iran, Islamic Republic of" "Iraq" "Ireland" "Isle of Man" "Israel" "Italy" "Ivory Coast" "Jamaica" "Japan" "Jersey" "Jordan" "Kazakhstan" "Kenya" "Kiribati" "North Korea" "South Korea" "Kuwait" "Kyrgyzstan" "Lao PDR" "Latvia" "Lebanon" "Lesotho" "Liberia" "Libya" "Liechtenstein" "Lithuania" "Luxembourg" "Macedonia, Republic of" "Madagascar" "Malawi" "Malaysia" "Maldives" "Mali" "Malta" "Marshall Islands" "Martinique" "Mauritania" "Mauritius" "Mayotte" "Mexico" "Micronesia, Federated States of" "Moldova" "Monaco" "Mongolia" "Montenegro" "Montserrat" "Morocco" "Mozambique" "Myanmar" "Namibia" "Nauru" "Nepal" "Netherlands" "Netherlands Antilles" "New Caledonia" "New Zealand" "Cape Verde" "Cayman Islands" "Central African Republic" "Chile" "China" "Hong Kong, SAR China" "Macao, SAR China" "Christmas Island" "Cocos (Keeling) Islands" "Colombia" "Comoros" "Congo (Brazzaville)" "Congo, (Kinshasa)" "Cook Islands" "Costa Rica" "Croatia" "Cuba" "Cyprus" "Czech Republic" "Denmark" "Djibouti" "Dominica" "Dominican Republic" "Ecuador" "Egypt" "El Salvador" "Equatorial Guinea" "Eritrea" "Nicaragua" "Niger" "Nigeria" "Niue" "Afghanistan" "Aland Islands" "Albania" "Algeria" "Burkina Faso" "Burundi" "Cambodia" "Cameroon" "Canada" "Norfolk Island" "Northern Mariana Islands" "Norway" "Oman" "Sri Lanka" "Sudan" "Suriname" "Svalbard and Jan Mayen Islands" "Swaziland" "Sweden" "Switzerland" "Syria" "Taiwan, Republic of China" "Tajikistan" "Tanzania, United Republic of" "Thailand" "Timor-Leste" "Togo" "Tokelau" "American Samoa" "Andorra" "Angola" "Anguilla" "Antarctica" "Antigua and Barbuda" "Argentina" "Armenia" "Aruba" "Australia" "Austria" "Azerbaijan" "Bahamas" "Bahrain" "Bangladesh" "Barbados" "Belarus" "Belgium" "Belize" "Benin" "Bermuda" "Bhutan" "Bolivia" "Bosnia and Herzegovina" "Botswana" "Bouvet Island" "Brazil" "British Virgin Islands" "British Indian Ocean Territory" "Brunei Darussalam" "Bulgaria" "Tonga" "Trinidad and Tobago" "Tunisia" "Turkey" "Turkmenistan" "Turks and Caicos Islands" "Tuvalu" "Uganda" "Peru" "Ukraine" "United Arab Emirates" "United States of America" "US Minor Outlying Islands" "Uruguay" "Uzbekistan" "Vanuatu" "Venezuela" "Viet Nam" "Virgin Islands, US" "Wallis and Futuna Islands" "Western Sahara" "Yemen" "Zambia" "Zimbabwe" "United States" "Pakistan" "Palau" "Palestinian Territory" "Panama" "Papua New Guinea" "Paraguay" "Philippines" "Pitcairn" "Poland" "Portugal" "Puerto Rico" "Qatar" "Reunion" "Romania" "Russian Federation" "Rwanda" "Saint Barthelemy" "Saint Helena" "Saint Kitts and Nevis" "Saint Lucia" "Saint-Martin (French part)" "Saint Pierre and Miquelon" "Saint Vincent and Grenadines" "Samoa" "San Marino" "Sao Tome and Principe" "Saudi Arabia" "Senegal" "Serbia" "Seychelles" "Sierra Leone" "Singapore" "Slovakia" "Slovenia" "Solomon Islands" "Somalia" "South Africa" "South Georgia and the South Sandwich Islands" "South Sudan" "Spain" "United States Minor Outlying Islands" "United Kingdom" "Hong Kong" "Curacao"
email
required
string <email>
phone
required
string^[+][0-9]{1,15}$
white-label
required
string <uri>
city
required
string [ 2 .. 35 ] characters
state
required
string [ 2 .. 35 ] characters
zip_code
required
string [ 2 .. 35 ] characters
first_name
required
string [ 2 .. 35 ] characters
middle_name
required
string
last_name
required
string [ 2 .. 35 ] characters
address_1
required
string [ 2 .. 35 ] characters
address_2
string
occupation
string [ 2 .. 35 ] characters
gender
required
string
Enum: "male" "female" "unknown"

Responses

Request samples

Content type
application/json
{
  • "birthdate": "2019-08-24",
  • "country": "Chad",
  • "email": "user@example.com",
  • "phone": "string",
  • "white-label": "http://example.com",
  • "city": "string",
  • "state": "string",
  • "zip_code": "string",
  • "first_name": "string",
  • "middle_name": "string",
  • "last_name": "string",
  • "address_1": "string",
  • "address_2": "string",
  • "occupation": "string",
  • "gender": "male"
}

Response samples

Content type
application/json
{ }

AddCorporateDetails

Add corporate details

Endpoint used to change card status.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
currentProfile
string
entityId
required
number
required
object

Responses

Request samples

Content type
application/json
{
  • "currentProfile": "string",
  • "entityId": 0,
  • "entityDetail": {
    }
}

Response samples

Content type
application/json
{ }

AddKybDocument

Add Kyb Document

Endpoint used to add KYB Document.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
documentName
required
string
issueOrExpiryDate
required
string^[0-9]{4}-[0-9]{2}-[0-9]{2}$
documentDescription
string
documentString
required
string
fileType
integer
Enum: 0 1 2 3 4 5

Responses

Request samples

Content type
application/json
{
  • "documentName": "string",
  • "issueOrExpiryDate": "string",
  • "documentDescription": "string",
  • "documentString": "string",
  • "fileType": 0
}

Response samples

Content type
application/json
{ }

AccountGroup

Account Group

a new account group in the system.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
groupName
string
groupCode
string

Responses

Request samples

Content type
application/json
{
  • "groupName": "Retail Customers",
  • "groupCode": "RC001"
}

Response samples

Content type
application/json
{ }

CreateAccountGroup

Create Account Group

Creates a new account group in the system.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
ibanList
required
Array of strings non-empty [ items^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$ ]
accountGroupName
required
string [ 2 .. 50 ] characters

Responses

Request samples

Content type
application/json
{
  • "ibanList": [
    ],
  • "accountGroupName": "string"
}

Response samples

Content type
application/json
{ }

CreateAccountStaffGroupMapping

create account staff group mapping

Endpoint used to create account staff group mapping.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
accountGroupUserGroupName
required
string [ 2 .. 50 ] characters ^[a-zA-Z0-9._-]+$
accountGroupName
required
string [ 2 .. 50 ] characters
userGroupName
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "accountGroupUserGroupName": "string",
  • "accountGroupName": "string",
  • "userGroupName": [
    ]
}

Response samples

Content type
application/json
{ }

ExtendAccountGroup

extend account group

Endpoint used to extend account group.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
ibanList
required
Array of strings non-empty [ items^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$ ]
accountGroupName
required
string [ 2 .. 50 ] characters

Responses

Request samples

Content type
application/json
{
  • "ibanList": [
    ],
  • "accountGroupName": "string"
}

Response samples

Content type
application/json
{ }

CreateCorporateEntity

create corporate entity

Endpoint used to create corporate entity.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
companyName
required
string [ 2 .. 50 ] characters
companyEmail
required
string <email>
tradingName
required
string [ 2 .. 50 ] characters
tinNumber
string [ 2 .. 15 ] characters
regNumber
required
string [ 2 .. 15 ] characters
phoneNumber
required
string [ 7 .. 15 ] characters
country
required
string [ 2 .. 50 ] characters
companyUrl
string <uri-template>
whiteLabel
required
string <uri-template> [ 2 .. 100 ] characters
entityType
required
string [ 2 .. 15 ] characters
Value: "corporate"

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{ }

CreateCorporateStaff

create corporate staff

Endpoint used to create corporate staff.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
email
required
string <email>
white-label
required
string <uri-template> [ 2 .. 100 ] characters
corporate_id
required
number

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{ }

CreateCardRequest

create card request

Endpoint used to create card request.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{ }

CreateIBANRequest

create IBAN request

Endpoint used to create IBANRequest.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
accountName
required
string
currencyName
required
string
providerId
required
integer
entityId
required
integer
isWalletUser
boolean
username
string

Responses

Request samples

Content type
application/json
{
  • "accountName": "string",
  • "currencyName": "string",
  • "providerId": 0,
  • "entityId": 0,
  • "isWalletUser": true,
  • "username": "string"
}

Response samples

Content type
application/json
{ }

CreatePaymentEUR

create payment EUR

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
paymentMethod
required
string [ 2 .. 50 ] characters
Value: "SEPA-SCT"
fromAccountIBAN
required
string [ 2 .. 50 ] characters
recipientName
required
string [ 2 .. 140 ] characters
toAccountIBAN
required
string [ 2 .. 50 ] characters
toBicCode
required
string [ 7 .. 15 ] characters
paymentReference
required
string [ 2 .. 35 ] characters
amount
required
number

Responses

Request samples

Content type
application/json
{
  • "paymentMethod": "SEPA-SCT",
  • "fromAccountIBAN": "string",
  • "recipientName": "string",
  • "toAccountIBAN": "string",
  • "toBicCode": "strings",
  • "paymentReference": "string",
  • "amount": 0
}

Response samples

Content type
application/json
{ }

CreatePaymentGBP

create payment GBP

Endpoint used to create payment GBP.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
One of
paymentMethod
string [ 3 .. 15 ] characters
Enum: "FPS" "CHAPS"
fromAccountNumber
required
string = 8 characters
fromSortCode
required
string = 6 characters
recipientName
required
string [ 1 .. 140 ] characters
toAccountNumber
required
string = 8 characters
toSortCode
required
string = 6 characters
type
string
Enum: "Personal" "Business"
paymentReference
required
string [ 1 .. 35 ] characters
bankName
required
string [ 1 .. 140 ] characters
amount
required
number
beneficiaryCity
string [ 1 .. 140 ] characters
beneficiaryState
string [ 1 .. 140 ] characters

Responses

Request samples

Content type
application/json
{
  • "paymentMethod": "FPS",
  • "beneficiaryCity": "string",
  • "beneficiaryState": "string",
  • "fromAccountNumber": "stringst",
  • "fromSortCode": "string",
  • "recipientName": "string",
  • "toAccountNumber": "stringst",
  • "toSortCode": "string",
  • "type": "Personal",
  • "paymentReference": "string",
  • "bankName": "string",
  • "amount": 0
}

CreatePaymentSWIFT

create payment swift

Endpoint used to create payment SWIFT.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
paymentMethod
required
string [ 2 .. 50 ] characters
Value: "SWIFT"
fromAccountIBAN
required
string [ 2 .. 50 ] characters
toAccountIBAN
required
string [ 2 .. 50 ] characters
currency
required
string = 3 characters
type
required
string [ 1 .. 15 ] characters
paymentReference
required
string [ 1 .. 140 ] characters
amount
required
number
beneficiaryName
required
string [ 2 .. 140 ] characters
beneficiaryAddr1
required
string [ 2 .. 70 ] characters
beneficiaryCity
required
string [ 2 .. 35 ] characters
beneficiaryState
required
string [ 2 .. 35 ] characters
beneficiaryCountry
required
string [ 2 .. 100 ] characters
beneficiaryPostCode
required
string [ 2 .. 25 ] characters
beneficiaryBankName
required
string [ 2 .. 140 ] characters
beneficiaryBankCodeType
required
string [ 2 .. 25 ] characters
Enum: "BIC" "ABA"
beneficiaryBankCode
required
string [ 2 .. 25 ] characters

Responses

Request samples

Content type
application/json
{
  • "paymentMethod": "SWIFT",
  • "fromAccountIBAN": "string",
  • "toAccountIBAN": "string",
  • "currency": "str",
  • "type": "string",
  • "paymentReference": "string",
  • "amount": 0,
  • "beneficiaryName": "string",
  • "beneficiaryAddr1": "string",
  • "beneficiaryCity": "string",
  • "beneficiaryState": "string",
  • "beneficiaryCountry": "string",
  • "beneficiaryPostCode": "string",
  • "beneficiaryBankName": "string",
  • "beneficiaryBankCodeType": "BIC",
  • "beneficiaryBankCode": "string"
}

Response samples

Content type
application/json
{ }

ChangeCardStatus

GetAccountsListing

get accounts listing

Endpoint used to get accounts listing.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
object (Empty Schema)

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{ }

GetAccountStaffMappingList

get account staff mapping list

Endpoint used to get account staff mapping list.

Authorizations:
(BearerAuthApiKeyAuth)

Responses

Response samples

Content type
application/json
{ }

GetCardDetails

get card details

Endpoint used to get card details.

Authorizations:
BearerAuth
query Parameters
card_id
required
string

Responses

Response samples

Content type
application/json
{ }

GetCardSensitiveDetails

get card sensitive details

Endpoint used to get card sensitive details.

Authorizations:
BearerAuth
query Parameters
card_id
required
string

Responses

Response samples

Content type
application/json
{ }

GetCardTransactions

get card transactions

Endpoint used to get card transactions.

Authorizations:
BearerAuth
query Parameters
card_id
required
string

Responses

Response samples

Content type
application/json
{ }

GetCountryList

get country list

Endpoint used to get country list.

Authorizations:
(BearerAuthApiKeyAuth)

Responses

Response samples

Content type
application/json
{ }

GetProviderDetails

get provider details

Endpoint used to get provider details.

Authorizations:
(BearerAuthApiKeyAuth)

Responses

Response samples

Content type
application/json
{ }

GetStaffsListing

get staffs listing

Endpoint used to get staff listing.

Authorizations:
(BearerAuthApiKeyAuth)

Responses

Response samples

Content type
application/json
{ }

GetTransactionDetails

get transaction details

Endpoint used to get transaction details.

Authorizations:
(BearerAuthApiKeyAuth)
Request Body schema: application/json
required
object (Empty Schema)

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{ }

GetTransactionRejectReason

get transaction reject-reason

Endpoint used to get transaction rejection reason.

Authorizations:
(BearerAuthApiKeyAuth)
query Parameters
transactionId
required
string
header Parameters
x-api-key
required
string

Responses

Response samples

Content type
application/json
{ }

GetTransactionReportByDate

get transaction report by date

Endpoint used to get transaction report by date.

Authorizations:
(BearerAuthApiKeyAuth)
query Parameters
date
required
string
header Parameters
x-api-key
required
string

Responses

Response samples

Content type
application/json
{ }

FireblocksWebhookManager

fireblocks webhook manager

Endpoint used for the fireblocks webhook manager

Responses

Response samples

Content type
application/json
{ }

SumsubWebhookManager

sumsub webhook manager

Endpoint used for the Sumsub webhook manager

Responses

Response samples

Content type
application/json
{ }

ValidateAPIModel

validate API model

Endpoint used to validate API model.

Authorizations:
(BearerAuthApiKeyAuth)

Responses

Response samples

Content type
application/json
{ }