CLclerk
Logs

List an event group's logs

Changed on

Returns the log entries of one event group past the ones a grouped page of GET /logs includes, oldest first, for loading more of a group. Accepts the same event filters as listing logs, so a filtered page keeps loading only matching events.

get/logs/groups/{group_id}/events

Request

  • Base URL
    https://api.clerk.com/v1
  • URL
    https://api.clerk.com/v1/logs/groups/{group_id}/events
  • Auth
    HTTP bearer

Path parameters

group_idstring required

The ID of the event group, e.g. a sign-in ID.

Query parameters

started_atinteger required

When the group started (Unix timestamp in milliseconds), the started_at of the group item. It bounds the time range searched.

limitinteger

Applies a limit to the number of results returned.

starting_afterstring

The group's events_cursor from the grouped view, or the starting_after cursor this endpoint returned. Only forward pagination is supported.

Response

A list of log entries with cursor-based pagination.

Example response

{
  "data": [
    {
      "object": "log",
      "actor_type": "dashboard_user",
      "event_context": {
        "device": {
          "location": {
            "country_code": "US"
          }
        }
      }
    }
  ]
}

Changes