The Individual End User Object

End Users are your users who should be created on Fiat Republic before you can start receiving or sending payments for them. We require a minimum set of details on your customers to fulfil our regulatory obligations and perform AML checks.

From April 7th activation of a new Individual End User will be fully asynchronous. This means that after a POST request the returned entity won't be with ACTIVE Status immediately, but CREATED.

Check Guides for more details here

Individual End User Object

AttributeDescriptionFormat / ENUMS
id
string
Unique identifier of the End User.e.g. eus_j82rl497g47g5ykvzn
person.firstName
string
First name of the End User.Can be built of singular value.
Must have only letters, hyphens and apostrophes.
Regex:^\\p{L}[\p{L}'-]\*$
person.middleName
string
Middle names of the End UserCan be built of multiple space separated segments.
Should be between 1 and 100 characters long and contain only letters, hyphens, dots and apostrophes.
Regex: ^[\\p{L}'][ \p{L}.'-]\*\\p{L}$
person.lastName
string
Last name of the End User.Can be built of multiple space separated segments.
Must consist of words that have only letters, hyphens and apostrophes.
Regex: ^[\\p{L}'][ \p{L}'-]\*\\p{L}$
person.address.line1
string
First line of the End User home address.Space and hyphen are allowed between the characters.
Max length 50
person.address.line2
string
Second line of the End User's home address.Space and hyphen are allowed between the characters.
Max length 50
person.address.city
string
City of the End User.Space and hyphen are allowed between the characters.
Max length 50
person.address.state
string
Region or state of the End User.Space and hyphen are allowed between the characters.
Max length 35
person.address.postalCode
string
Postal/Zip code of the End User.Validation regex:

- for GB: ^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9]a-zA-Z[cikmovCIKMOV]]{2}$
- for Estonia: ^\\d{5}\$
- for Ireland: (?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$
- others: ^[\p{L}\d] [\p{L}\s\d\-]{1,8}[\p{L}\d]$
person.address.country
string
End User's Country of residence.Two-letter ISO 3166-1 alpha-2 country code e.g. GB or US
person.email
string
Email address of the End User.
person.phone
string
Phone number of the End User.Including the country prefix e.g. +447788661100

- must start with a plus sign (+).

- should have country code (e.g., +1, +44, etc.) followed by the appropriate number of digits (min = 8, max = 15)
person.birthCountry
string
Country of birth of the End User.Two-letter ISO 3166-1 alpha-2 country code e.g. FR or CA
person.nationality
array of strings
One or more nationalities of the End User.Two-letter ISO 3166-1 alpha-2 country code e.g. AU or BE
person.identificationDocument.numberNumber of identity document
person.identificationDocument.typeType of identity documentExamples:
WORK_PERMIT,
PASSPORT,
NATIONAL_ID,
DRIVERS_LICENCE
dob
date
Date of birth of the End User.YYYY-MM-DD format e.g. 1975-04-05
ipAddress
string
The IP address from where the individual signed up on your platform.e.g. 86.23.22.163
annualSalaryRange
string
Value of annual salary of the Individual End User (in EUR)Ranges:

- 0 to 25000
- 25000 to 50000
- 50000 to 100000
- 100000 to 150000
- above 150000
tags
array of strings
Tags allowing you to provide additional risk-related information for the individual.PEP
status
string
Status of the End User.CREATED , IN_REVIEW,ACTIVE, SUSPENDED,REJECTED, CLOSED
createdAt
integer
Epoch Timestamp at which the object was created.e.g. 1637049210552
updatedAt
integer
Epoch Timestamp at which the object was last updated.e.g. 1637049210552
metadata
array of strings
Additional data in JSON key:value format.See Metadata for more information
linkedCryptoWallets
array of objects
Details of any known crypto wallets linked with the individual being created.
linkedCryptoWallets.coin
string
Symbol of the coin or token.e.g. BTC
linkedCryptoWallets.walletAddress
string
Blockchain wallet address of the coin or token.e.g 3d1f7363-f6b3-1705-le5c-e4dfc7k8192n
linkedCryptoWallets.relationship
array of strings
One or more relationships between the individual and the walletAddress.OWN, SENDER or RECEIVER
riskRating
string
Rating of the risk level assigned to the user.LOW, MEDIUM, HIGH
signupAt
integer
A date of registration of End User profile within Member platforme.g. 1637049210552

After creating an Individual End User, you will be able to create one or more Virtual Accounts for them.