Registrations API

Manage event registrations, attendees, and check-in processes.

List Registrations

GET

/api/v1/events/{event_id}/registrations

Retrieve registrations for an event

Query Parameters

Parameter	Type	Description
status	`string`	Filter by status (PENDING, CONFIRMED, CANCELLED, ATTENDED)
limit	`number`	Max results Default: `50`
offset	`number`	Skip results Default: `0`

Request

curl -X GET "https://api.webkasa.app/api/v1/events/evt_abc123/registrations?status=CONFIRMED" \
  -H "Authorization: Bearer wk_live_xxx..."

Response

{
  "data": [
    {
      "id": "reg_abc123",
      "event_id": "evt_abc123",
      "attendee_name": "John Doe",
      "attendee_email": "john@example.com",
      "attendee_phone": "+1234567890",
      "status": "CONFIRMED",
      "guest_count": 2,
      "notes": "Dietary restrictions: vegan",
      "created_at": "2024-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "total": 15,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Create Registration

POST

/api/v1/events/{event_id}/registrations

Request Body

Parameter	Type	Description
attendee_email required	`string`	Attendee email address
attendee_name required	`string`	Attendee name
attendee_phone	`string`	Attendee phone number
status	`string`	Registration status Default: `PENDING`
guest_count	`number`	Number of additional guests Default: `0`
notes	`string`	Additional notes or requirements

Request

curl -X POST "https://api.webkasa.app/api/v1/events/evt_abc123/registrations" \
  -H "Authorization: Bearer wk_live_xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "attendee_email": "user@example.com",
    "attendee_name": "John Doe",
    "attendee_phone": "+1234567890",
    "status": "PENDING",
    "guest_count": 2,
    "notes": "Dietary restrictions: vegan"
  }'

Response

{
  "data": {
    "id": "reg_abc123",
    "event_id": "evt_abc123",
    "attendee_name": "John Doe",
    "attendee_email": "user@example.com",
    "status": "PENDING",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Registration Statuses

Registrations can have the following statuses:

PENDING

Awaiting confirmation or payment

CONFIRMED

Registration confirmed

CANCELLED

Registration cancelled

ATTENDED

Attendee checked in at event

Guest Count

The guest_count field represents additional guests beyond the primary registrant. For example:

guest_count: 0 = 1 total attendee (just the registrant)
guest_count: 2 = 3 total attendees (registrant + 2 guests)

When checking capacity, the total attendees (1 + guest_count) is counted against available slots.