Skip to content

Get details about a Directory Record
Deprecated

Request

⚠️ Deprecation Notice: The following endpoint is deprecated.

Retrieves the details of a single Directory Record.

Returns the full Directory Record instance for the given ID, including its approval status, unique identifiers, and linked device (if any).

About Directory Records

A Directory Record represents a device tracked through the registration/approval workflow ahead of or during enrollment. Once approved and enrolled, the record's device_id field links it to the corresponding device.

Security
esper_cloud_api_apiKey
Path
enterprise_idstring, (uuid)required

Enterprise ID

directory_record_idstring, (uuid)required

Directory record ID

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v1/enterprise/{enterprise_id}/directory_record/{directory_record_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Directory record information

Bodyapplication/json
idstring(Directory Record ID)
namestring(Device name)
online_statusstring
Enum:"ONLINE""OFFLINE""NONE"
aliasstring(Alias name)
tagsArray of strings(Tags)
group_idstring, (uuid)(Group ID)
device_idstring, (uuid)(Device ID)
approval_statusstring(Approval Status)
Enum:"WAITING_FOR_APPROVAL""APPROVED""REJECTED""BLOCKED"
provisioned_onstring, (date-time)(Provisioned on)read-only
unique_identifiersArray of objects(Unique Identifiers)
Response
{
  "id": "string",
  "name": "string",
  "online_status": "ONLINE",
  "alias": "string",
  "tags": [
    "string"
  ],
  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
  "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
  "approval_status": "WAITING_FOR_APPROVAL",
  "provisioned_on": "2019-08-24T14:15:22Z",
  "unique_identifiers": [
    { … }
  ]
}