Skip to main content
POST
/
v1
/
events
/
search
Search/list events with filters
curl --request POST \
  --url https://api.quivly.com/v1/events/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customer_id": "<string>",
  "event_code": "<string>",
  "event_type": "credit",
  "created_at_from": "2023-11-07T05:31:56Z",
  "created_at_to": "2023-11-07T05:31:56Z",
  "event_id": "<string>",
  "event_property_filters": {},
  "limit": 50,
  "offset": 0
}'
{
  "events": [
    {
      "event_id": "abc-123",
      "customer_id": "pied-piper",
      "event_code": "api_call",
      "event_type": "credit",
      "created_at": "2025-03-25T12:00:00Z",
      "event_properties": {
        "tokens": "300",
        "status_code": 200,
        "region": "us-west-1",
        "response_time_ms": 120
      }
    },
    {
      "event_id": "def-456",
      "customer_id": "pied-piper",
      "event_code": "api_call",
      "event_type": "credit",
      "created_at": "2025-03-26T09:15:00Z",
      "event_properties": {
        "tokens": "150",
        "status_code": 200,
        "region": "us-west-1",
        "response_time_ms": 110
      }
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
customer_id
string
​
event_code
string
​
event_type
enum<string>
Available options:
credit,
debit
​
created_at_from
string<date-time>
​
created_at_to
string<date-time>
​
event_id
string
​
event_property_filters
object
​
limit
integer
default:50
Required range: x <= 100
​
offset
integer
default:0

Response

List of events matching the filters.

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