API referenceEvents
List events
Events of the last 30 days, newest first, with their delivery status per endpoint. Use it to reconcile after an outage: everything your endpoint missed is here.
Filters: type, created_since, delivery_status.
Scope: events:read.
Authorization
bearerAuth AuthorizationBearer <token>
A Platform API token, wyc_live_... or wyc_test_..., created at Settings > API tokens in the dashboard.
In: header
Query Parameters
type?string
Value in
- "allocation.created"
- "allocation.planted"
- "allocation.monitored"
- "allocation.updated"
- "planting.updated"
- "verification.published"
- "recipient.created"
- "recipient.claimed"
- "certificate.created"
delivery_status?string
Only events with at least one delivery in this state.
Value in
- "pending"
- "delivered"
- "failed"
created_since?string
Only objects created at or after this ISO 8601 time.
Format
date-timelimit?integer
Number of objects to return, 1 to 100.
Range
1 <= value <= 100Default
25starting_after?string
Cursor: the id of the last object of the previous page.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/events"{ "object": "list", "url": "/v2/events", "has_more": false, "data": [ { "id": "evt_7rCkZa8bW1vT9yN6pDmQ2xL3", "object": "event", "livemode": true, "type": "allocation.planted", "created": "2026-01-15T08:05:00Z", "data": { "object": { "id": "alloc_6yN3pDmQ2xL7rCkZa8bW1vT9", "object": "allocation", "livemode": true, "trees": 250, "status": "monitored", "source": "foundation", "planting": "plt_4vT9bW1kZa8yN3pDmQ2xL7rC", "project": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "recipient": null, "certificate": null, "allocated_at": "2026-01-15T08:05:00Z", "planted_at": "2026-01-12", "legacy_tree_ids": [], "legacy_order_id": null, "created_at": "2026-01-15T08:05:00Z", "updated_at": "2026-07-21T10:00:00Z" } }, "deliveries": [ { "endpoint": "whe_2xL7rCkZa8bW1vT9yN6pDmQ3", "status": "delivered", "attempts": 1, "last_attempt_at": "2026-01-15T08:05:02Z", "last_status_code": 200 } ] } ]}