EventsSearch events by type

Search events by type

Return recent events of one type across the workspace.

curl -X GET "https://api.flameup.ai/api/v1/events/search?event=example_string&since=2024-12-25T10%3A00%3A00Z&limit=50" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "events": [
    {
      "id": "example_string",
      "type": "purchase_completed",
      "person_id": "123e4567-e89b-12d3-a456-426614174000",
      "parameters": {},
      "created_at": "2024-12-25T10:00:00Z"
    }
  ],
  "total": 42
}
GET
/events/search
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Your Flameup API key (passed as Bearer token)

Your Flameup API key (passed as Bearer token)
query
eventstring
Required

The event name to search for.

query
sincestring

Only return events at or after this time (RFC 3339).

Format: date-time
query
limitinteger

Capped at 500 — a larger value is silently reduced, not rejected.

Max: 500
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Your Flameup API key (passed as Bearer token)

Query Parameters

eventstring
Required

The event name to search for.

sincestring

Only return events at or after this time (RFC 3339).

limitinteger

Capped at 500 — a larger value is silently reduced, not rejected.

Responses

successboolean
eventsarray
totalinteger