GET/v1/customers/{external_id}/devices
List a customer's devices
Needs usage:read.
curl 'https://api.entitler.co/v1/customers/ada/devices' \
-H "Authorization: Bearer $ENTITLER_KEY"Credentials
Send any one of these:
- Bearer token
Path parameters
| Name | Type | Description |
|---|---|---|
external_idrequired | string | The customer's external ID, or me for the customer a customer token or identity token names. |
Query parameters
| Name | Type | Description |
|---|---|---|
target.team_id | string | |
target.project_id | string | |
target.environment_id | string | |
page_size | integer (int64) | |
page_token | string |
Responses
200The ListCustomerDevicesResponse message.
ListCustomerDevicesResponse
devicesarray of DevicerequiredexternalIdstringrequiredidstringrequiredlastActiveAtintegerrequiredat least 0; at most 18446744073709552000
namestringsessionDeviceSessiondeviceIdstringrequiredexpiresAtintegerrequiredat least 0; at most 18446744073709552000
idstringrequiredleaseSecondsinteger (int64)requiredat least 0; at most 4294967295
startedAtintegerrequiredat least 0; at most 18446744073709552000
signedInAtintegerrequiredat least 0; at most 18446744073709552000
typestring
inUseDeviceCountcountinteger (int64)requiredat least 0; at most 4294967295
limitinteger (int64)requiredat least 0; at most 4294967295
lockoutsarray of DeviceLockoutrequiredbreachesinteger (int64)requiredat least 0; at most 4294967295
kindcommon.DeviceLimitKindrequiredOne of
DEVICE_LIMIT_KIND_UNSPECIFIED,DEVICE_LIMIT_KIND_SIGNED_IN,DEVICE_LIMIT_KIND_IN_USE.lockedUntilintegerat least 0; at most 18446744073709552000
nextPageTokenstringsignedInDeviceCountcountinteger (int64)requiredat least 0; at most 4294967295
limitinteger (int64)requiredat least 0; at most 4294967295
ErrorA refusal, with the HTTP status of its gRPC code.
Error
errorobjectrequiredcodestringrequiredparametersobjectrequiredEach value: string
reasonstringor nullrequired