Events — Increase

Events

Events are records of things that happened to objects at Increase. Events are accessible via the List Events endpoint and can be delivered to your application via webhooks. For more information, see our webhooks guide.

The Event object

{
  "associated_object_id": "account_in71c4amph0vgo2qllky",
  "associated_object_type": "account",
  "category": "account.created",
  "created_at": "2020-01-31T23:59:59Z",
  "id": "event_001dzz0r20rzr4zrhrr1364hy80",
  "type": "event"
}

Attributes

associated_object_id

string

The identifier of the object that generated this Event.

associated_object_type

string

The type of the object that generated this Event.

category

enum

The category of the Event. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.

created_at

string

The time the Event was created.

string

The Event identifier.

type

string

A constant representing the object’s type. For this resource it will always be event.

List Events

curl \
  --url "${INCREASE_URL}/events" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Returns a list response :

{
  "data": [
    { /* Event object */ },
    { /* Event object */ }
    /* ... */
  ],
  "next_cursor": "v57w5d",
}

Parameters

category.in

array of strings

Filter Events for those with the specified category or categories. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three.

associated_object_id

string

Filter Events to those belonging to the object with the provided identifier.

order_by.direction

enum

The direction to order in.

order_by.field

enum

The field to order by.

cursor

string

limit

integer

created_at.after

string

created_at.before

string

created_at.on_or_after

string

created_at.on_or_before

string

Retrieve an Event

curl \
  --url "${INCREASE_URL}/events/event_001dzz0r20rzr4zrhrr1364hy80" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Parameters

event_id

string

Required

The identifier of the Event.

More about Events.