Duo Security
API actions for the Duo Security integration.
Duo Security
Manage Duo Security users and the devices they use to log in.
Get Duo Security user
Retrieve details for a specific user by their Duo user ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | The Duo user ID to retrieve. |
Response
{
"email": "jsmith@example.com",
"realname": "John Smith",
"status": "active",
"user_id": "DUXXXXXXXXXXXXXXXXXX",
"username": "jsmith"
}Get Duo Security user devices
Retrieve the list of authentication devices (phones) associated with a Duo user.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | The Duo user ID to retrieve devices for. |
Response
[
{
"number": "+15551234567",
"phone_id": "DPXXXXXXXXXXXXXXXXXX",
"platform": "Apple iOS",
"type": "mobile"
}
]List Duo Security users
Retrieve a list of users from Duo Security. Results are returned in pages of up to 300 users.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of users to return (1-300, default 100). |
offset | number | No | The number of users to skip before the list starts (default 0). Use this to see later pages of results. |
Response
[
{
"email": "jsmith@example.com",
"realname": "John Smith",
"status": "active",
"user_id": "DUXXXXXXXXXXXXXXXXXX",
"username": "jsmith"
}
]