The /userinfo Endpoint

Use this page to retrieve OIDC-style user identity data from Clever with an SSO bearer access token.

Overview

The /userinfo endpoint returns user identity information that is typically associated with an OIDC flow.

To call this endpoint, send a GET request to https://api.clever.com/userinfo and authenticate with the user’s SSO bearer access_token.

For details on obtaining an access_token, see OAuth Implementation.

This endpoint is especially useful for Clever Library integrations, where OIDC identity tokens are not currently supported.

🚧

How can I view all roles for a user?

The /userinfo endpoint only returns the role of the user in the current login context.

If you need the full set of roles associated with that user, call /users/{id} with an SSO bearer token or district-app token.

Example request

curl -X GET "https://api.clever.com/userinfo" \
  -H "Authorization: Bearer YOUR_SSO_BEARER_TOKEN" \
  -H "Content-Type: application/json"

Example response

{
  "sub": "64f0e2926b100a053fc08e14",
  "user_id": "64f0e2876b100a053fbf9c6e",
  "multi_role_user_id": "64f0e2926b100a053fc08e14",
  "user_type": "teacher",
  "district_id": "64ef5e6c8d6b17762d094e48",
  "district": "64ef5e6c8d6b17762d094e48",
  "email": "[email protected]",
  "name": {
    "first": "John-Paul",
    "last": "Johnson",
    "middle": ""
  },
  "schools": [],
  "given_name": "John-Paul",
  "family_name": "Johnson",
  "email_verified": false,
  "authorized_by": "district"
}