Skip to main content
GET
/
v1
/
events
List Events
curl --request GET \
  --url https://events-api.monk.com/v1/events \
  --header 'Authorization: Bearer <token>'
{
  "events": [
    {
      "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "eventName": "api_call",
      "idempotencyKey": "evt_2026_02_15_api_call_abc123",
      "timestamp": "2026-02-15T14:30:00Z",
      "properties": {
        "model": "gpt-4",
        "tokens": "1500"
      }
    }
  ],
  "total": 142,
  "limit": 50,
  "offset": 0,
  "hasMore": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
eventName
string

Filter by event name

​
customerId
string

Filter by Monk customer UUID

​
start
string<date>

Start date filter (YYYY-MM-DD), inclusive

​
end
string<date>

End date filter (YYYY-MM-DD), exclusive

​
limit
integer
default:100
​
offset
integer
default:0

Response

Paginated list of events

​
events
object[]
​
total
integer
​
limit
integer
​
offset
integer
​
hasMore
boolean