Nookhive Logo
StyleguideAPI Reference

Bookings API

Manage event registrations, attendee information, and booking status.

Overview

The Bookings API allows you to manage event registrations, including creating, updating, and retrieving booking information. Bookings are always associated with a specific event.

Bookings include attendee details, payment status, and ticket information.

Base Path

https://api.nookhive.com/v1/events/{slug}/bookings

Endpoints

GET/v1/events/{slug}/bookings

List Bookings

Returns a paginated list of all bookings for a specific event.

Parameters

NameTypeDescription
slug*stringEvent slug
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
statusstringFilter by payment status: PENDING, PAID, CANCELLED, REFUNDED
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/events/annual-conference-2026/bookings?status=PAID" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
ResponseJSON
{
  "bookings": [
    {
      "id": "bkg_abc123",
      "eventSlug": "annual-conference-2026",
      "attendee": {
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "+1234567890",
        "company": "Acme Corp"
      },
      "ticketType": "Standard Ticket",
      "quantity": 2,
      "totalAmount": 398.00,
      "currency": "USD",
      "paymentStatus": "PAID",
      "paidAt": "2026-01-10T15:30:00Z",
      "createdAt": "2026-01-10T15:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}
GET/v1/events/{slug}/bookings/{id}

Get Booking Details

Retrieve detailed information about a specific booking.

Parameters

NameTypeDescription
slug*stringEvent slug
id*stringBooking ID
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/events/annual-conference-2026/bookings/bkg_abc123" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
POST/v1/events/{slug}/bookings

Create Booking

Create a new booking for an event. Used for manual registrations or integrations.

Parameters

NameTypeDescription
slug*stringEvent slug
attendee*objectAttendee information object
ticketTypeId*stringThe ticket type ID
quantityintegerNumber of tickets (default: 1)
paymentStatusstringInitial payment status (default: PENDING)
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/events/annual-conference-2026/bookings" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "attendee": {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "phone": "+1987654321",
      "company": "Tech Inc"
    },
    "ticketTypeId": "tt_standard",
    "quantity": 1,
    "paymentStatus": "PAID"
  }'
POST/v1/events/{slug}/bookings/{id}/mark-paid

Mark Booking as Paid

Update the payment status of a booking to PAID. Useful for offline payments.

Parameters

NameTypeDescription
slug*stringEvent slug
id*stringBooking ID
paymentMethodstringPayment method used (e.g., CASH, TRANSFER)
paymentReferencestringExternal payment reference
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/events/annual-conference-2026/bookings/bkg_abc123/mark-paid" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": "BANK_TRANSFER",
    "paymentReference": "TXN-20260115-001"
  }'
POST/v1/events/{slug}/bookings/{id}/resend-confirmation

Resend Confirmation Email

Resend the booking confirmation email to the attendee.

Parameters

NameTypeDescription
slug*stringEvent slug
id*stringBooking ID
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/events/annual-conference-2026/bookings/bkg_abc123/resend-confirmation" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
POST/v1/events/{slug}/bookings/{id}/send-reminder

Send Reminder Email

Send a reminder email to the attendee about the upcoming event.

Parameters

NameTypeDescription
slug*stringEvent slug
id*stringBooking ID
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/events/annual-conference-2026/bookings/bkg_abc123/send-reminder" \
  -H "Authorization: Bearer nk_live_your_api_key_here"

The Booking Object

{
  "id": "bkg_abc123",
  "eventId": "evt_example123",
  "eventSlug": "annual-conference-2026",
  "attendee": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "company": "Acme Corp"
  },
  "ticketType": {
    "id": "tt_standard",
    "name": "Standard Ticket",
    "price": 199.00
  },
  "quantity": 2,
  "subtotal": 398.00,
  "discount": 0.00,
  "totalAmount": 398.00,
  "currency": "USD",
  "paymentStatus": "PAID",
  "paymentMethod": "CARD",
  "paymentReference": "pi_abc123",
  "paidAt": "2026-01-10T15:30:00Z",
  "checkInStatus": "NOT_CHECKED_IN",
  "checkedInAt": null,
  "confirmationSentAt": "2026-01-10T15:30:00Z",
  "createdAt": "2026-01-10T15:00:00Z",
  "updatedAt": "2026-01-10T15:30:00Z"
}