Skip to content

Get all Directory Records
Deprecated

Request

⚠️ Deprecation Notice: The following endpoint is deprecated.

Lists all Directory Record instances for an enterprise.

Returns a paginated list (count/next/previous/results) of Directory Records, which are used for device registration and approval workflows before a device is fully onboarded.

About Directory Records

A Directory Record represents a device that has been identified for onboarding via a unique identifier (IMEI, serial number, MEI, or MAC address) before or during enrollment, tracking its approval status as it moves toward being provisioned. Each record can be linked to a device group and carries its own online status, alias, and tags.

Security
esper_cloud_api_apiKey
Path
enterprise_idstring, (uuid)required

Enterprise ID

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

Responses

Directory records

Bodyapplication/json
countinteger
previousstring
nextstring
resultsArray of objects(DirectoryRecord)
Response
{
  "count": 0,
  "previous": "string",
  "next": "string",
  "results": [
    { … }
  ]
}