GET /api/v1/devices
Lists all devices with pagination support.
Note: To list all devices enrolled by a user, use the List all devices endpoint in the User Resources API.
You can return a subset of devices that match a supported search criteria using the search query parameter.
Searches for devices based on the properties specified in the search parameter conforming SCIM filter specifications (case-insensitive). This data is eventually consistent. The API returns different results depending on specified queries in the request. Empty list is returned if no objects match search request.
Note: The
searchparameter results are sourced from an eventually consistent datasource and may not reflect the latest information.
Don't use search results directly for record updates, as the data might be stale and therefore overwrite newer data, resulting in data loss.
Use an id lookup for records that you update to ensure your results contain the latest data.
This operation requires URL encoding. For example, search=profile.displayName eq "Bob" is encoded as search=profile.displayName%20eq%20%22Bob%22.
Servers
- https://{yourOktaDomain}
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit |
Integer | No |
A limit on the number of objects to return (recommend Default value: 200 |
after |
String | No | |
search |
String | No |
A SCIM filter expression that filters the results. Searches include all device Searches for devices can be filtered by the contains ( |
expand |
String | No |
Includes associated user details and management status for the device in the Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.