Scopes & Permissions

Universal Verify uses OAuth scopes to control what user data your application can access. This guide explains the available scopes and their requirements.

Available Scopes

Basic Scopes (All Plans)

verification

Access to user verification status and confidence level.

  • Required for basic human verification
  • Provides verified and verification_confidence fields in user info response

openid

Access to basic user identifier.

  • Required for OIDC compliance
  • Provides id_token field during token exchange

Paid Plan Scopes

age

Access to user's age in years.

  • Available on Standard and Enterprise plans
  • Provides age field in user info response
  • Useful for age-restricted content

Enterprise Plan Scopes

legal_name

Access to user's legal name information.

  • Available only on Enterprise plan
  • Provides name object with first_name, middle_names, last_name, suffix, and full_name as optional fields in regional user info response
  • Requires additional data handling compliance

date_of_birth

Access to user's date of birth.

  • Available only on Enterprise plan
  • Provides date_of_birth field (YYYY-MM-DD format) in regional user info response
  • Requires additional data handling compliance

id_type

Access to information about the ID used for verification.

  • Available only on Enterprise plan
  • Provides id_type object with country, type, and state fields in regional user info response
  • Requires additional data handling compliance

Requesting Scopes

When creating an authorization URL, you can specify which scopes you need:

const authUrl = frontendSDK.createAuthorizationUrl({
    codeChallenge: codeChallenge,
    redirectUrl: 'https://your-app.com/callback',
    scope: 'verification openid age' // Specify required scopes
});

If no scope is specified, all approved scopes for your integration will be requested.

Compliance Guidelines

Important Notice: The following guidelines are provided for informational purposes only. Universal Verify is not responsible for how partners handle, store, or process user data. Partners are solely responsible for ensuring their own compliance with applicable laws, regulations, and industry standards. We recommend consulting with legal counsel to ensure your implementation meets all necessary requirements.

Data Handling

  • Store sensitive data securely
  • Implement proper data retention policies
  • Handle data deletion requests promptly
  • Comply with relevant privacy laws (GDPR, CCPA, etc.)

Enterprise Scopes

  • Follow the data residency requirements of the region the information is stored in
  • Get consent from your users for any international cross-border transfers of their data

Best Practices

  • Request only the scopes you need
  • Implement proper data handling and security measures
  • Regularly review and update your scope requirements
  • Have a clear data retention and deletion policy