Skip to main content
Version: 1.0.0

Unizo Identity Management API

The Unizo Identity Management API provides comprehensive access to identity and access management (IAM) data across your organization. This unified API enables you to retrieve detailed information about users, groups, sessions, and authentication events from various identity providers including Active Directory, Okta, Azure AD, and more.

Key Features​

  • User Management: Access complete user profiles including authentication status, MFA configurations, devices, and group memberships
  • Group Management: Retrieve group hierarchies, memberships, and privilege assignments
  • Session Monitoring: Track active and historical user sessions with device and location information
  • Multi-Factor Authentication: Monitor MFA enrollment status and authentication methods
  • Device Management: Track user devices, compliance status, and security posture
  • LDAP Integration: Access synchronized directory information including organizational hierarchy

Authentication​

All API requests require authentication using an API key. Include your API key in the X-API-Key header:

X-API-Key: your-api-key-here

Rate Limits​

API requests are rate-limited to ensure fair usage:

  • Default: 1000 requests per hour
  • Burst: 100 requests per minute

Rate limit information is included in response headers:

  • X-Rate-Limit-Remaining: Number of requests remaining in current window
  • X-Rate-Limit-Reset: Unix timestamp when the rate limit resets

Pagination​

List endpoints support pagination using offset and limit parameters:

  • limit: Number of items to return (max: 100, default: 20)
  • offset: Number of items to skip (default: 0)

Total counts are provided in the X-Total-Count response header.

Error Handling​

The API uses standard HTTP status codes and returns detailed error information in a consistent format. See the Error Response schema for details.

Authentication​

API key for authentication. You can obtain an API key from the Unizo portal under Settings > API Keys. Include this key in all API requests.

Security Scheme Type:

apiKey

Header parameter name:

apiKey

Contact

Unizo Support: support@unizo.ai

URL: https://support.unizo.ai