List User Accounts

Retrieve a paginated list of user accounts belonging to your admin key.

Request

GET /v1/admin/users
Authorization: Bearer {admin_key}

Query Parameters

Parameter	Type	Default	Description
limit	integer	20	Number of results (1-100)
offset	integer	0	Pagination offset
status	string	-	Filter by status: active, suspended, pending

Example Request

curl -X GET "https://api.insight.iagon.com/v1/admin/users?status=active&limit=10" \
  -H "Authorization: Bearer YOUR_ADMIN_KEY"

Response

Success (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "admin_key_id": "660e8400-e29b-41d4-a716-446655440001",
      "admin_entity_name": "YourCompany",
      "external_id": "cust_abc123",
      "name": "Acme Corporation",
      "email": "api@acme.com",
      "metadata": {},
      "created_at": "2026-01-26T12:00:00Z",
      "updated_at": null,
      "status": "active",
      "billing_plan": "pro"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "admin_key_id": "660e8400-e29b-41d4-a716-446655440001",
      "admin_entity_name": "YourCompany",
      "external_id": "cust_xyz789",
      "name": "Beta Inc",
      "email": "dev@beta.io",
      "metadata": {},
      "created_at": "2026-01-25T10:00:00Z",
      "updated_at": null,
      "status": "active",
      "billing_plan": "starter"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 2,
    "hasMore": false
  }
}

Pagination

The response includes pagination info:

Field	Description
limit	Requested page size
offset	Current offset
total	Total number of matching users
hasMore	Whether more results exist

Notes

• Results are ordered by created_at descending (newest first)
• You can only see users created by your admin key
• Use status filter to find suspended users that need attention