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.

Some of these can also be easily inspected in the statistics section of the client dashboard.

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	Fractal has contacted the user to provide further information and has yet to do so.
expired	The user has an expired POA or POI and the client has expiration enabled.

Total verifications

GET https://RESOURCE_DOMAIN/v2/stats/total-verifications

Returns total number of user verifications that are approved, contacted, rejected or pending right now.

Headers

Name	Type	Description
Content-Type	string	application/json
Authorization	string	Bearer {access-token}

200

{
  "approved": 55,
  "contacted": 4,
  "rejected": 10,
  "pending": 7
}

Verifications by countries

GET https://RESOURCE_DOMAIN/v2/stats/country-verifications

Returns total number of user verifications that are approved, contacted, rejected or pending by countries.

Headers

Name	Type	Description
Content-Type	string	application/json
Authorization	string	Bearer {access-token}

200

{
  "US": {
    "approved": 8,
    "contacted": 1,
    "rejected": 2,
    "pending": 3
  },
  "DK": {
    "approved": 12
  },
  "RO": {
    "approved": 3
  }
}

Verifications by user ids

GET https://RESOURCE_DOMAIN/v2/stats/user-verifications

Returns user ids and their status, which can be approved, pending, contacted or rejected.

Headers

Name	Type	Description
Content-Type	string	application/json
Authorization	string	Bearer {access-token}

200

[
    {
      "user_id": "320bfdaa-213e-41fb-8d77-ed98c415f01e",
      "level": "v1",
      "credential": "approved"
    },
    {
      "user_id": "320bfdaa-213e-41fb-8d77-ed98c415f01e",
      "level": "light+selfie+wallet",
      "credential": "pending",
    }
]