# Okta API

**Provider:** Okta
**Category:** auth
**Base URL:** `https://{yourOktaDomain}/api/v1`
**Auth:** api-key — `Authorization: SSWS YOUR_API_TOKEN`
**Rate Limit:** 1,000 requests/min (default) · Varies by endpoint
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.okta.com/docs/reference/

## Description

Okta is the enterprise identity platform, and its Management API exposes full control over user lifecycle, group membership, application assignments, authentication policies, MFA factors, API tokens, and SSO/SAML/OIDC integrations. The API uses a REST architecture and supports event hooks for real-time identity events. Used by IT teams, security engineers, and SaaS developers to automate provisioning, deprovisioning, and compliance workflows.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://{yourOktaDomain}/api/v1/users` | List users with filtering and search |
| POST | `https://{yourOktaDomain}/api/v1/users` | Create and optionally activate a user |
| GET | `https://{yourOktaDomain}/api/v1/users/{userId}` | Get a specific user by ID or login |
| POST | `https://{yourOktaDomain}/api/v1/users/{userId}/lifecycle/activate` | Activate a user account |
| GET | `https://{yourOktaDomain}/api/v1/groups` | List groups and their membership |
| GET | `https://{yourOktaDomain}/api/v1/apps` | List all app integrations in your org |

## Authentication

Create an API token in Okta Admin Console → Security → API. Pass it in the Authorization header prefixed with "SSWS".

```
Authorization: SSWS YOUR_API_TOKEN
```

## Sample Request

```bash
curl "https://mycompany.okta.com/api/v1/users?limit=5&filter=status+eq+%22ACTIVE%22" \
  -H "Authorization: SSWS $OKTA_API_TOKEN" \
  -H "Accept: application/json"
```

## Sample Response

```json
[{
  "id": "00u1gNFGB8xZjMn4Y1d8",
  "status": "ACTIVE",
  "profile": {
    "firstName": "Alice",
    "lastName": "Chen",
    "email": "alice@company.com",
    "login": "alice@company.com"
  },
  "created": "2023-01-15T10:00:00.000Z"
}]
```

## Pricing Details

Developer: free for 100 MAU. Workforce: from $2/user/mo. Customer Identity: from $0.05/MAU. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/okta/) — CC BY 4.0*