Application statistics

You can retrieve information about how many users, and their individual KYC statuses, authorized your application.

To access information related to your application, you must obtain an access token using the client credentials grant, described in the previous section. You'll need to provide a token with the client.stats:read scope, which can be acquired via a client credentials grant.

User statuses

Status

Meaning

approved

User was issued a Credential for the requested KYC Level.

rejected

User was refused a Credential for the requested KYC Level.

pending

User has submitted information for review, either for the first time or as a follow-up to a contact, and is waiting to have their identity verified.

contacted

User has been contacted by Fractal to provide further information, and has yet to do so.

get
Total verifications

https://VERIFIER_DOMAIN/api/stats/total-verifications
Returns total number of user verifications that are approved, contacted, rejected or pending right now.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authorization
required
string
Bearer {access-token}
Response
200: OK
{
"approved": 55,
"contacted": 4,
"rejected": 10,
"pending": 7
}

get
Verifications by countries

https://VERIFIER_DOMAIN/api/stats/country-verifications
Returns total number of user verifications that are approved, contacted, rejected or pending by countries.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authorization
required
string
Bearer {access-token}
Response
200: OK
{
"US": {
"approved": 8,
"contacted": 1,
"rejected": 2,
"pending": 3
},
"DK": {
"approved": 12
},
"RO": {
"approved": 3
}
}

get
Verifications by user ids

https://VERIFIER_DOMAIN/api/stats/user-verifications
Returns user ids and their status, which can be approved, pending or rejected.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authorization
required
string
Bearer {access-token}
Response
200: OK
[
{
"user_id": "320bfdaa-213e-41fb-8d77-ed98c415f01e",
"level": "v1",
"credential": "approved"
},
{
"user_id": "320bfdaa-213e-41fb-8d77-ed98c415f01e",
"level": "light+selfie+wallet",
"credential": "pending",
}
]