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.

get
Retrieve user information

https://RESOURCE_DOMAIN/users/me
This endpoint returns JSON. The scopes associated with the access token will define which fields will be returned.
Request
Response
Request
Headers
Content-Type
optional
string
application/json
Authorization
required
string
Bearer access_token
Response
200: OK
response1.json supposes access_token has the following scopes, with plus, selfie and wallet verifications emitted. * uid:read * contact:read * verification.plus:read * verification.selfie:read * verification.wallet:read * verification.wallet.details:read response2.json suppose access_token has the following scopes: * uid:read * verification.plus:read * verification.plus.details:read * verification.selfie:read * verification.selfie.details:read * verification.wallet:read * verification.wallet.details:read
response1.json
response2.json
response1.json
{
"emails": [
{
"address": "example@frctls.com"
}
],
"phones:": [
{
"number": "+44000000000"
}
],
"uid": "b76ab44d-b71e-4d19-b6f9-f6e88cd73946",
"verification_cases": [
{
"details": null,
"level": "plus+selfie",
"status": "pending",
"credential": "pending",
},
{
"details": null,
"level": "basic+liveness",
"status": "done",
"credential": "approved",
},
{
"details": {
"wallet_address": "0xa1eD7e13271bFeB758CB5CB6F3EdcC97A0E5943D",
"wallet_currency": "ETH"
},
"level": "wallet",
"report": {
"mock_response": true,
"report_id": "28df4599a4256830a4285af140b00868a0e3566ad79ca058f609e6b7ea151fcb",
"is_smart_contract": false,
"version": "3.3",
"report_type": "standard",
"report_time": "2019-07-29T15:24:29.422Z",
"report_block_height": 1,
"address": "a1eD7e13271bFeB758CB5CB6F3EdcC97A0E5943D",
"address_type": "ETH",
"address_subtype": "ETH",
"address_used": false,
"address_estimation": null,
"cscore": 0,
"multisig": null,
"whitelist": false,
"cc_balance": 0,
"usd_balance": 0,
"usd_exchange_rate": 0,
"profiles": [],
"cscore_info": [],
"assets_total_usd_value": 0,
"assets_count": 4,
"indicators": null
}
}
]
}
response2.json
{
"institution": null,
"person": {
"date_of_birth": "1967-08-16",
"full_name": "David Muller",
"identification_document_country": "DE",
"identification_document_front_file": "<URL>",
"identification_document_number": "123456789",
"identification_document_selfie_file": "<URL>",
"identification_document_type": "passport",
"place_of_birth": "Berlin",
"residential_address": "Wiener Straße 10, Berlin, 10999",
"residential_address_country": "DE",
"residential_address_proof_file": "<URL>",
"wallet_address": "0xa1eD7e13271bFeB758CB5CB6F3EdcC97A0E5943D",
"wallet_currency": "ETH"
},
"uid": "b76ab44d-b71e-4d19-b6f9-f6e88cd73946",
"verifications": [
{
"details": {
"residential_address_country": "DE",
"residential_address_proof_file": "<URL>",
"residential_address": "Wiener Straße 10, Berlin, 10999",
"identification_document_type": "passport",
"place_of_birth": "Berlin",
"date_of_birth": "1967-08-16",
"full_name": "David Muller",
"identification_document_country": "DE",
"identification_document_number": "123456789"
},
"level": "plus",
"report": null
},
{
"details": {
"identification_document_selfie_file": "<URL>",
"identification_document_front_file": "<URL>"
},
"level": "selfie",
"report": null
},
{
"details": {
"wallet_address": "0xa1eD7e13271bFeB758CB5CB6F3EdcC97A0E5943D",
"wallet_currency": "ETH"
},
"level": "wallet",
"report": {
"mock_response": true,
"report_id": "28df4599a4256830a4285af140b00868a0e3566ad79ca058f609e6b7ea151fcb",
"is_smart_contract": false,
"version": "3.3",
"report_type": "standard",
"report_time": "2019-07-29T15:24:29.422Z",
"report_block_height": 1,
"address": "a1eD7e13271bFeB758CB5CB6F3EdcC97A0E5943D",
"address_type": "ETH",
"address_subtype": "ETH",
"address_used": false,
"address_estimation": null,
"cscore": 0,
"multisig": null,
"whitelist": false,
"cc_balance": 0,
"usd_balance": 0,
"usd_exchange_rate": 0,
"profiles": [],
"cscore_info": [],
"assets_total_usd_value": 0,
"assets_count": 4,
"indicators": null
}
}
]
}

Response fields

Top level

Field

Type / Format

Description

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

institution

object

[Deprecated] Use verification_cases instead.

The user data fields for an institutional user.

person

object

[Deprecated] Use verification_cases instead.

The user data fields for an individual user.

verifications

array

[Deprecated] Use verification_cases instead.

The list of verifications given to this user.

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:

Field

Type / Format

Description

address

string

A email address, confirmed to belong to the user

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:

Field

Type / Format

Description

number

string

A phone number, confirmed to belong to the user, in E.164 format (e.g. +4400000000000)

verification_cases

A verification case represents represents information that has been validated internally by Fractal. Verifications are emitted separately per each level and add-ons. A verification request for light+video will generate two verifications, one per item.

Field

Type / Format

Description

level

string

The level (or add-on) that this verification refers to.

status

pending

contacted

done

  • pending: if Fractal needs to take action,

  • contacted: if the user needs to take action

  • done: if Fractal has reached a conclusion

credential

pending

approved

rejected

The outcome of our analysis.

  • approved: The user fulfills all the requirements

  • rejected: The user is unable to fulfill all the requirements

  • pending: Fractal is still evaluating the case

id

string

A unique identifier for this verification case.

details

object

The set of user data fields (see below for details) that have been validated with respect to this level or add-on. For more details on these fields, please check the details section below.

report

object

Valid only for the wallet add-on verification. The AML report generated by Coinfirm for the cryptocurrency address present under details.

For further information on the report fields, please refer to the the Coinfirm documentation.

[Deprecated] institution

This field will be removed on 2020-06-15. Use verification_cases instead.

[Deprecated] person

This field will be removed on 2020-06-15. Use verification_cases instead.

[Deprecated] verifications

This field will be removed on 2020-06-15. Use verification_cases instead.

details

The set of fields enumerated below contains the information submitted by the user. The version of the information validated in the context of a 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 persons only, while others are institution only. These will be marked in the "Restrictions" column below.

Field

Type / Format

KYC level availability

Restrictions

date_of_birth

YYYY-MM-DD

light

plus

basic

full_name

string

light

plus

basic

identification_document_back_file

URL

selfie

basic

identification_document_country

ISO 3166-1 alpha-2

light

plus

basic

identification_document_front_file

URL

selfie

basic

identification_document_number

string

light

plus

basic

identification_document_type

national_id

passport

drivers_license

light

plus

place_of_birth

string

light

plus

identification_document_selfie_file

URL

selfie

liveness

boolean

liveness

These fields will only be available if the user is an institution and not a natural person.

Field

Type / Format

KYC level availability

Restrictions

articles_of_association_file

URL

light

plus

beneficial_owner

string

light

plus

certificate_of_corporate_status_file

URL

light

plus

Canada institution

certificate_of_good_standing_file

URL

light

plus

USA institution

certificate_of_incorporation_file

URL

light

plus

USA & Canada institution

commercial_register_entry_file

URL

light

plus

commercial_register

string

light

plus

company_name

string

light

plus

company_seat

string

light

plus

jurisdiction

string

light

plus

legal_form

string

light

plus

managing_directors

string

light

plus

owner_identity_proof_file

URL

light

plus

power_of_attorney_file

URL

light

plus

secretary_certificate_file

URL

light

plus

USA & Canada institution

shareholders_list_file

URL

light

plus

transparency_register_entry_file

URL

light

plus

unique_identification_number

string

light

plus

USA, Singapore & Hong-Kong institution

Field

Type / Format

KYC level availability

Restrictions

residential_address_country

ISO 3166-1 alpha-2

light

plus

residential_address_proof_file

URL

light

plus

residential_address

string

light

plus

Field

Type / Format

KYC level availability

Restrictions

wallet_address

string

wallet

wallet_currency

BTC or ETH

wallet

wallet_check_reports

array

wallet

wallet_check_reports contains an array of every AML report we requested from Coinfirm for this user's wallet address during the verification case process. For more information on the report fields, please refer to the the Coinfirm documentation.

Field

Type / Format

KYC level availability

Restrictions

sow_estimated_net_worth_currency

EUR or USD

sow

sow_estimated_net_worth_value

string

sow

Field

Type / Format

KYC level availability

Restrictions

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

Field

Type / Format

KYC level availability

Restrictions

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

Field

Type / Format

KYC level availability

Restrictions

social_security_number

string

ssn

USA residents only

URLs are set expire a few hours after they were requested.