Skip to main content
GET
/
identities
List all identities in the current workspace with optional filtering and pagination.
curl --request GET \
  --url https://api.edges.run/v1/identities \
  --header 'X-API-Key: <api-key>'
[
  {
    "uid": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_uid": "5678e456-e89b-12d3-a456-426614174001",
    "created_at": "2023-10-01T12:00:00Z",
    "name": "John Doe",
    "timezone": "Europe/Paris",
    "type": "standard",
    "is_active": "true",
    "integrations": [
      "app1",
      "app2"
    ]
  },
  {
    "uid": "123e4567-e89b-12d3-a456-426614174005",
    "workspace_uid": "5678e456-e89b-12d3-a456-426614174001",
    "created_at": "2023-10-01T12:05:00Z",
    "name": "Jane Smith",
    "type": "engagement",
    "timezone": "America/New_York",
    "is_active": "false",
    "integrations": []
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.edges.run/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key required for authentication. Add your API key in the X-API-Key header.

Query Parameters

​
query
string | null

Search identities by their name.

​
retrieve_accounts
boolean | null

Whether to include associated integrations for each identity. Note: Enabling this will increase response time.

​
page
integer
default:1

The page number to retrieve (1-based indexing).

Required range: x >= 1

Response

Successfully retrieved users.

​
workspace_uid
string<uuid>
required
​
timezone
string
required
​
type
enum<string>
required
Available options:
standard,
engagement
​
uid
string<uuid>
​
created_at
string<date-time>
​
name
string | null
​
is_active
boolean
default:false
​
integrations
string[]