Retrieve the list of a customer's events

get

https://read-api.<environment>.antavo.com/v1/customers/{customer_id}/events

Returns paginated list of events registered in the customer's events history.
Results can be filtered and sorted by action, date, account, expdate and points event attribute values.

Path Params

customer_id

string

required

Customer identifier. Using an external ID is not supported.

Query Params

offset

integer

≥ 0

Defaults to 0

Offsets the starting position in the sorted result set. Used for pagination together with the limit query parameter.

limit

integer

1 to 1000

Defaults to 20

Sets the maximum number of items to return from the sorted result set. Used for pagination together with the offset query parameter.

filter

object

Filter by allowed fields and operators.

sort

array of objects

Sorts results by one or more fields in the specified order. Each field can be used only once.
When multiple sort instructions are provided, the first field is used as the primary sort field. Each additional field determines the order of results that have the same value for the preceding field.
Example: ?sort[0][field]=action&sort[0][direction]=asc&sort[1][field]=points&sort[1][direction]=desc

sort

Responses

Language

Loading…

Response

Choose an example:

application/json

200Success - Customer event data provided

401Error - Escher signature missing or invalid.

422Error - Request validation failed.

5XXError - Unexpected server error.