List Identities
Retrieve a paginated list of visitor identities
GET https://api.orwel.io/api/v1/identities
Query Parameters
limitintegerquerydefault: 50Maximum number of results to return (max: 100)
offsetintegerquerydefault: 0Number of results to skip for pagination
emailstringqueryFilter identities by email address
visitor_idstringqueryFilter identities by visitor ID (UUID)
is_favoritebooleanqueryFilter favorite identities (true/false)
created_afterstringqueryFilter identities created after this date (ISO 8601 format)
created_beforestringqueryFilter identities created before this date (ISO 8601 format)
Response
dataarrayArray of visitor identity objects
paginationobjectPagination information
Request
curl -X GET "https://api.orwel.io/api/v1/identities?limit=10&is_favorite=true" \
-H "Authorization: Bearer orwel_sk_YOUR_KEY"const response = await fetch(
'https://api.orwel.io/api/v1/identities?limit=10&is_favorite=true',
{
headers: {
'Authorization': 'Bearer orwel_sk_YOUR_KEY'
}
}
);
const data = await response.json();import requests
headers = {
'Authorization': 'Bearer orwel_sk_YOUR_KEY'
}
params = {
'limit': 10,
'is_favorite': True
}
response = requests.get(
'https://api.orwel.io/api/v1/identities',
headers=headers,
params=params
)
data = response.json()Response
{
"data": [
{
"id": "ee0e8400-e29b-41d4-a716-446655440009",
"workspace_id": "770e8400-e29b-41d4-a716-446655440002",
"visitor_id": "660e8400-e29b-41d4-a716-446655440001",
"email": "user@example.com",
"name": "John Visitor",
"traits": {
"plan": "enterprise",
"company": "Acme Corp"
},
"first_seen": "2025-01-10T08:00:00Z",
"last_seen": "2025-01-15T16:30:00Z",
"ip": "192.168.1.1",
"city": "San Francisco",
"country": "USA",
"is_favorite": true,
"created_at": "2025-01-10T08:00:00Z"
}
],
"pagination": {
"limit": 10,
"offset": 0,
"total": 250
}
}