User information retrieval
As soon as you obtain an user's access token, you are able to access the status of their verification case and the personal information they submitted.
You can also access the user's provided information, as well as their KYC process status, in the user explorer within the client dashboard.
Retrieve user information
GET
https://RESOURCE_DOMAIN/v2/users/me
This endpoint returns JSON. The scopes associated with the access token will define which fields will be returned.
Headers
Content-Type
string
application/json
Authorization
string
Bearer
access_token
Response fields
Top level
uid
string
This user's unique identifier.
emails
array
A list of email addresses belonging to the user.
phones
array
A list of phone numbers belonging to the user.
verification_cases
array
The verification cases that you requested for this user.
wallets
array
The wallets this user has provided during onboarding.
emails
emails
An array of email addresses belonging to the user. Available when users sign up using an email address. We do not support more than one email address. If the user registered using a phone number, this may be an empty array. Each email entry contains the following fields:
address
string
A email address, confirmed to belong to the user
source_type
enum(string)
registration - verified authentication email address
journey - unverified email address, not used for authentication
obsolete - verified authentication email address that is no longer in use
phones
phones
An array of phone numbers belonging to the user. Available when users sign up using a phone number. We do not support more than one phone number. If the user registered using an email address, this may be an empty array. Each phone entry contains the following fields:
number
string
A phone number, confirmed to belong to the user, in E.164 format (e.g. +4400000000000
)
verification_cases
verification_cases
A verification case represents information that has been validated internally by Fractal. Verifications are emitted separately per each level and add-ons. A verification request for basic+liveness
will generate two verifications, one per item.
level
string
The level (or add-on) that this verification refers to.
journey_completed
boolean
true
once a user completes all the journey steps required by your scopes, and gets redirected to redirect_uri
. false
until then.
status
pending
contacted
done
pending
: if Fractal needs to take action,contacted
: if the user needs to take actiondone
: if Fractal has reached a conclusion
credential
pending
approved
rejected
The outcome of our analysis.
approved
: The user fulfills all the requirementsrejected
: The user is unable to fulfill all the requirementspending
: Fractal is still evaluating the case
id
string
A unique identifier for this verification case.
details
object
report
object
[Deprecated] Coinfirm integration has been deprecated. If you wish to use Coinfirm, please integrate with it directly.
wallets
wallets
An array of wallet addresses and currencies the user has provided during onboarding. This array can be empty if you did not request the user to share a wallet address during onboarding. The array can grow even after the user is approved, as users are allowed to update their wallet addresses and decide with which applications they want to share them.
At this time, this array cannot shrink.
Please note that the wallet currency is merely representative of the addon that was used to request the wallet. For example, if you have used the wallet-eth
addon to request any EVM-compatible wallet, the currency will be eth
.
id
uuid
A unique identifier for the wallet.
address
string
The wallet address.
currency
ada
algo
btc
eth
kar
sol
substrate
sui
xrp
The wallet currency derived from the used wallet addon.
verified
boolean
Indicates wether the ownership of the wallet has been confirmed with Fractal.
details
details
The set of fields enumerated below contains the information submitted by the user. The version of the information validated in the context of verification will be present under the details
key in each member of the verification_cases
array. As our process evolves, we may add or remove fields from this list.
Some fields are available for natural person
s only, while others are institution
only. These will be marked in the "Restrictions" column below.
Identification related fields
date_of_birth
YYYY-MM-DD
plus
basic
full_name
string
plus
basic
identification_document_back_file
URL
selfie
basic
identification_document_country
plus
basic
identification_document_front_file
URL
selfie
basic
identification_document_number
string
plus
basic
identification_document_type
national_id
passport
drivers_license
plus
place_of_birth
string
plus
identification_document_selfie_file
URL
selfie
identification_document_date_of_issue
YYYY-MM-DD
plus
basic
identification_document_date_of_expiry
YYYY-MM-DD
plus
basic
Liveness related fields
liveness_audit_best_file
will generally be the best image of the user. liveness_audit_least_similar_file
is the least similar image to the first image. liveness_audit_open_eyes_file
is the image where the users' eyes are the most open. liveness_audit_quality{1,2,3}_file
are the next 3 highest images.
liveness
boolean
liveness
liveness_audit_best_file
URL
liveness
liveness_audit_least_similar_file
URL
liveness
liveness_audit_open_eyes_file
URL
liveness
liveness_audit_quality1_file
URL
liveness
liveness_audit_quality2_file
URL
liveness
liveness_audit_quality3_file
URL
liveness
Institution related fields
These fields will only be available if the user is an institution and not a natural person.
articles_of_association_file
URL
plus
beneficial_owner
string
plus
certificate_of_corporate_status_file
URL
plus
Canada institution
certificate_of_good_standing_file
URL
plus
USA institution
certificate_of_incorporation_file
URL
plus
USA & Canada institution
commercial_register_entry_file
URL
plus
commercial_register
string
plus
company_name
string
plus
company_seat
string
plus
jurisdiction
string
plus
legal_form
string
plus
managing_directors
string
plus
owner_identity_proof_file
URL
plus
power_of_attorney_file
URL
plus
secretary_certificate_file
URL
plus
USA & Canada institution
shareholders_list_file
URL
plus
transparency_register_entry_file
URL
plus
unique_identification_number
string
plus
USA, Singapore & Hong-Kong institution
Residency related fields
residential_address_country
plus
residential_address_proof_file
URL
plus
residential_address
string
plus
residential_address_line1
string
plus
This field is required only for applications with split address configuration enabled. For, the rest is optional.
residential_address_line2
string
plus
This field is required only for applications with split address configuration enabled. For, the rest is optional.
residential_address_city
string
plus
This field is required only for applications with split address configuration enabled. For, the rest is optional.
residential_address_zip
string
plus
This field is required only for applications with split address configuration enabled. For , the rest is optional.
residential_address_proof_date_of_expiry
YYYY-MM-DD
plus
Source of wealth related fields
sow_estimated_net_worth_currency
EUR
or USD
sow
sow_estimated_net_worth_value
string
sow
sow_balance_sheet_file
URL
sow
institution
sow_cash_flow_statement_file
URL
sow
institution
sow_income_statement_file
URL
sow
institution
sow_unaudited_accountant_name
string
sow
institution
sow_unaudited_accountant_professional_body
string
sow
institution
sow_type
crypto
dividends
divorce_settlement
freelance
gifts
inheritance
lease_revenue
life_policy
pension
salary
sale_of_company
sale_of_property
sale_of_shares
sow
person
sow_crypto_bank_statement_file
URL
sow
person
sow_crypto_source_of_initial_investment_file
URL
sow
person
sow_crypto_transactions_last_3_months_file
URL
sow
person
sow_dividends_bank_statement_file
URL
sow
person
sow_dividends_entitlement_file
URL
sow
person
sow_divorce_settlement_bank_statement_file
URL
sow
person
sow_divorce_settlement_proof_file
URL
sow
person
sow_freelance_bank_statement_file
URL
sow
person
sow_freelance_last_year_tax_returns_file
URL
sow
person
sow_freelance_service_contracts_file
URL
sow
person
sow_gifts_bank_statement_file
URL
sow
person
sow_gifts_name_of_donator
string
sow
person
sow_gifts_reason_for_donation
string
sow
person
sow_gifts_relationship_with_donator
string
sow
person
sow_inheritance_bank_statement_file
URL
sow
person
sow_inheritance_proof_file
URL
sow
person
sow_lease_revenue_agreement_file
URL
sow
person
sow_lease_revenue_bank_statement_file
URL
sow
person
sow_life_policy_bank_statement_file
URL
sow
person
sow_life_policy_closing_statement_file
URL
sow
person
sow_pension_bank_statement_file
URL
sow
person
sow_pension_statement_file
URL
sow
person
sow_salary_bank_statement_file
URL
sow
person
sow_salary_last_year_tax_returns_file
URL
sow
person
sow_salary_pay_slips_last_3_months_file
URL
sow
person
sow_sale_of_company_bank_statement_file
URL
sow
person
sow_sale_of_company_contract_file
URL
sow
person
sow_sale_of_property_bank_statement_file
URL
sow
person
sow_sale_of_property_contract_file
URL
sow
person
sow_sale_of_shares_bank_statement_file
URL
sow
person
sow_sale_of_shares_proof_file
URL
sow
person
Social security related fields
social_security_number
string
ssn
USA residents only
URLs are set expire a few hours after they were requested.
Last updated