Get Edges

Time	Status	User Agent
Retrieving recent requests…

Overview

Returns the list of Edges configured for your organization. An Edge represents a proxy through which devices on a local network can be reached.

Authorization

This endpoint requires Authorization.

Query Parameters

Key	Type	Description	Required
page	Integer	Page number (default: 1).	No
per_page	Integer	Items per page (default: 100, max: 100).	No

Response

Returns Paginated data of the following format for each item:

Key	Subkey	Type	Description
id		String	Unique identifier for the Edge.
display_name		String	Human-readable display name of the Edge.
status		String	Current status of the Edge: `online` / `offline`.
customer		Object	Customer space this Edge is tied to.
	id	String	Identifier of the customer space.
	name	String	Name of the customer space.
last_sync_at		Datetime	Timestamp of the last successful sync (nullable).
created_at		Datetime	Creation timestamp.
updated_at		Datetime	Last update timestamp.

{
  "items": [
    {
      "id": "5e7b1f0a-3c2d-4e5f-9a8b-1c2d3e4f5a6b",
      "display_name": "HQ Edge",
      "status": "online",
      "customer": {
        "id": "f1e2d3c4-b5a6-7890-1234-567890abcdef",
        "name": "Acme HQ"
      },
      "last_sync_at": "2026-05-14T09:00:00Z",
      "created_at": "2026-05-01T12:00:00Z",
      "updated_at": "2026-05-14T09:00:00Z"
    }
  ],
  "next_page": null
}

Errors

Status	Description
401	Missing or invalid `Authorization` header.