Events API
The event feed: every event webhooks deliver, readable with a cursor.
2 operations. Guide: Track events on the timeline. Requests and responses are JSON with snake_case fields; authenticate with Authorization: Bearer <api key>. The examples assume a client built as in SDKs and the command line.
List events
GET /v1/events
Cursor-paginated feed of the key's events, newest first: the same objects webhooks deliver, for the key's mode and environment plus project-level events. Events younger than a few seconds are left out, so tailing with before never skips one.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | no | Default 20. |
after | query | string | no | A UUID. |
before | query | string | no | A UUID. |
types | query | string | no | Comma-separated event types. |
email_id | query | string | no | A UUID. |
contact_id | query | string | no | A UUID. |
since | query | string (date-time) | no | An ISO 8601 timestamp with timezone, for example 2026-10-24T18:00:00.000Z. |
Response
200 Success: object.
| Field | Type | Required | Description |
|---|---|---|---|
object | "list" | yes | |
data | array of Event | yes | |
data[]. | string | yes | A UUID. |
data[]. | one of "live", "test" | yes | |
data[]. | one of "email.sent", "email.scheduled", "email.delivered", "email.delivery_delayed", "email.complained", "email.bounced", "email.opened", "email.clicked", "email.received", "email.failed", "email.suppressed", "email.canceled", … | yes | |
data[]. | string (date-time) | yes | An ISO 8601 timestamp with timezone, for example 2026-10-24T18:00:00.000Z. |
data[]. | map of any | yes | |
has_more | boolean | yes |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, with the error body.
Examples
curl https://api.minket.com/v1/events \
-H "Authorization: Bearer $MINKET_API_KEY"const result = await minket.events.list();minket api listEventsfrom minket.api.events import list_events
result = list_events.sync(client=client)res, err := client.ListEventsWithResponse(ctx, &minket.ListEventsParams{})Get an event
GET /v1/events/{id}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | A UUID. |
Response
200 Success: Event.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | A UUID. |
mode | one of "live", "test" | yes | |
type | one of "email.sent", "email.scheduled", "email.delivered", "email.delivery_delayed", "email.complained", "email.bounced", "email.opened", "email.clicked", "email.received", "email.failed", "email.suppressed", "email.canceled", … | yes | |
created_at | string (date-time) | yes | An ISO 8601 timestamp with timezone, for example 2026-10-24T18:00:00.000Z. |
data | map of any | yes |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, with the error body.
Examples
curl https://api.minket.com/v1/events/019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4a5b \
-H "Authorization: Bearer $MINKET_API_KEY"const result = await minket.events.get("019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4a5b");minket api getEvent 019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4a5bfrom minket.api.events import get_event
result = get_event.sync("019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4a5b", client=client)res, err := client.GetEventWithResponse(ctx, "019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4a5b")