Events | E2C Store API

API docs: Events

List events

GET/api/v1/eventsevents:read

Returns events, newest first by when they were created (not by event date). Deleted events are never returned. List entries don't include description or ticket_types; retrieve the event for those.

Query parameters

Parameter	Description
`status`string	`active`, `inactive`, or `incomplete`.
`updated_since`date	ISO 8601 date or date-time. Covers creation and edits made in the dashboard's event editor.
`category`string	Only listings in the category with this code.
`q`string	Search event name or code.
`limit`integer	1–100, default 25.
`cursor`string	The `next_cursor` from the previous page.

Request

curl "https://e2c.store/api/v1/events?status=active" \
  -H "Authorization: Bearer $E2C_API_KEY"

Response

{
  "data": [
    {
      "code": "autumn-market",
      "name": "Autumn Makers Market",
      "sku": "",
      "brand": "Maple & Thread",
      "category": { "code": "markets", "name": "Markets" },
      "status": "active",
      "currency": "CAD",
      "price": 15,
      "compare_at_price": null,
      "short_description": "40 local makers under one roof.",
      "created_at": "2026-08-01T14:00:00Z",
      "updated_at": "2026-09-10T18:15:00Z",
      "starts_at": "2026-10-17T14:00:00Z",
      "ends_at": "2026-10-17T21:00:00Z",
      "timezone": "America/Toronto",
      "location": { "type": "venue", "venue_name": "The Foundry", "details": "55 Mill St, Toronto", "online_instructions": null },
      "min_age": null,
      "age_policy": null,
      "event_policy": "Tickets are non-refundable.",
      "contact": { "name": "Grace H.", "email": "[email protected]" }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

starts_at and ends_at are in UTC like every other time in the API; timezone is the zone the event was scheduled in, for showing local times. ends_at is null when no end time is set. location.type is venue, online, or tba.

Retrieve an event

GET/api/v1/events/{code}events:read

Returns one event with its full description and active ticket types, including how many of each have sold. Look it up by its code.

Request

curl "https://e2c.store/api/v1/events/autumn-market" \
  -H "Authorization: Bearer $E2C_API_KEY"

Response

{
  "data": {
    "code": "autumn-market",
    "name": "Autumn Makers Market",
    "sku": "",
    "brand": "Maple & Thread",
    "category": { "code": "markets", "name": "Markets" },
    "status": "active",
    "currency": "CAD",
    "price": 15,
    "compare_at_price": null,
    "short_description": "40 local makers under one roof.",
    "created_at": "2026-08-01T14:00:00Z",
    "updated_at": "2026-09-10T18:15:00Z",
    "starts_at": "2026-10-17T14:00:00Z",
    "ends_at": "2026-10-17T21:00:00Z",
    "timezone": "America/Toronto",
    "location": { "type": "venue", "venue_name": "The Foundry", "details": "55 Mill St, Toronto", "online_instructions": null },
    "min_age": null,
    "age_policy": null,
    "event_policy": "Tickets are non-refundable.",
    "contact": { "name": "Grace H.", "email": "[email protected]" },
    "description": "<p>Shop handmade goods from...</p>",
    "ticket_types": [
      { "name": "General admission", "description": "", "price": 15, "capacity": 300, "sold": 212, "available": 88 },
      { "name": "Early bird", "description": "Entry at 9 AM", "price": 25, "capacity": null, "sold": 40, "available": null }
    ]
  }
}

sold counts confirmed and checked-in tickets plus tickets held in a checkout that is still in progress, so it matches what your store uses to stop overselling. capacity and available are null for ticket types with no limit.