REST API Reference
Explore the comprehensive EventzR REST API. All endpoints are prefixed with https://api.eventzr.com/v1.
Events Resource Core
GET/events
Retrieve a paginated list of events. Supports filtering by date, status, and venue.
Parameters
| Name | Type | Description |
|---|---|---|
| limit | integer | Max items to return (1-100). |
| status | string | Filter: published, draft, cancelled. |
| venue_id | string | Filter by specific venue ID. |
Response
{
"data": [
{
"id": "evt_123",
"title": "Tech Conf",
"status": "published"
},
{
"id": "evt_456",
"title": "Music Fest",
"status": "draft"
}
],
"meta": {
"page": 1,
"total": 24
}
}POST/events
Create a new event. Requires 'events:write' scope.
Parameters
| Name | Type | Description |
|---|---|---|
| title* | string | Event title. |
| start_date* | string | ISO 8601 date string. |
| venue_id* | string | Valid Venue ID. |
Response
{
"id": "evt_789",
"title": "New Launch Party",
"status": "draft",
"created_at": "2026-01-15T10:00:00Z"
}Ticketing Resource Commerce
POST/tickets/validate
Validate a ticket code for entry. Returns ticket status and attendee info.
Parameters
| Name | Type | Description |
|---|---|---|
| code* | string | Scanned QR code data. |
| device_id | string | ID of scanning device. |
Response
{
"valid": true,
"ticket": {
"id": "tkt_999",
"type": "VIP"
},
"attendee": {
"name": "Alice Smith",
"email": "alice@example.com"
},
"check_in_time": "2026-01-15T14:30:00Z"
}