How to fetch a specific event via API
Last updated 4 months ago
To a single event, send a GET request to the /api/events/:id endpoint, where id is the ID of the resource that you want to retrieve.
GET
/api/events/:id
id
GET https://yourdomain.commercelayer.io/api/events/:id
The following request fetches the event identified by the id "xYZkjABcde":
curl -g -X GET \ 'https://yourdomain.commercelayer.io/api/events/xYZkjABcde' \ -H 'Accept: application/vnd.api+json' \ -H 'Authorization: Bearer your-access-token'
On success, the API responds with a 200 OK status code, returning a single resource object:
200 OK
{ "data": { "id": "xYZkjABcde", "type": "events", "links": { "self": "https://yourdomain.commercelayer.io/api/events/xYZkjABcde" }, "attributes": { "name": "orders.create", "created_at": "2018-01-01T12:00:00.000Z", "updated_at": "2018-01-01T12:00:00.000Z", "reference": "ANY-EXTERNAL-REFEFERNCE", "reference_origin": "ANY-EXTERNAL-REFEFERNCE-ORIGIN", "metadata": { "foo": "bar" } }, "relationships": { "webhooks": { "links": { "self": "https://yourdomain.commercelayer.io/api/events/xYZkjABcde/relationships/webhooks", "related": "https://yourdomain.commercelayer.io/api/events/xYZkjABcde/webhooks" } }, "last_event_callbacks": { "links": { "self": "https://yourdomain.commercelayer.io/api/events/xYZkjABcde/relationships/last_event_callbacks", "related": "https://yourdomain.commercelayer.io/api/events/xYZkjABcde/last_event_callbacks" } } }, "meta": { "mode": "test", "organization_id": "xRRkjDFafe", "trace_id": "69abaa3545913c78132e5578bd26208d44aa9043647d78698fd0021f3958cd74" } } }