List Health Events

Returns a paginated list of resource health events. Events track verification and reconciliation results over time.

Request

GET /api/v1/resource-health/events

Authentication

Requires a valid access token with org admin role.

Authorization: Bearer <access_token>

Query Parameters

Parameter	Type	Default	Description
page	integer	0	Page number (zero-based)
size	integer	20	Page size
resourceId	string (UUID)	—	Optional filter by resource ID

Response

200 OK

{
  "content": [
    {
      "id": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
      "resourceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "resourceName": "prod-api-sg",
      "eventType": "VERIFY_FAILED",
      "message": "User is not authorized to perform: ec2:DescribeSecurityGroups",
      "createdAt": "2026-03-22T10:30:00Z"
    },
    {
      "id": "e2d3c4b5-a697-8901-fedc-ba9876543210",
      "resourceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "resourceName": "prod-api-sg",
      "eventType": "VERIFY_OK",
      "message": null,
      "createdAt": "2026-03-22T11:00:00Z"
    }
  ],
  "totalElements": 42,
  "totalPages": 3,
  "number": 0,
  "size": 20
}

Response Fields

Field	Type	Description
content	array	List of events for the current page
content[].id	string (UUID)	Event ID
content[].resourceId	string (UUID)	Resource ID
content[].resourceName	string	Resource display name
content[].eventType	string	VERIFY_OK, VERIFY_FAILED, RECONCILE_OK, or RECONCILE_FAILED
content[].message	string	Error message (null for OK events)
content[].createdAt	string (ISO 8601)	When the event occurred
totalElements	integer	Total number of events
totalPages	integer	Total number of pages
number	integer	Current page number (zero-based)
size	integer	Page size

Error Responses

Status	Description
401	Missing or invalid access token
403	User is not an org admin

Examples

List all events

curl -s "https://app.entryguard.io/api/v1/resource-health/events?page=0&size=20" \
  -H "Authorization: Bearer <token>"

Filter by resource

curl -s "https://app.entryguard.io/api/v1/resource-health/events?resourceId=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer <token>"