REST API access and endpoints

API token format, authentication, key endpoints, filtering, and cursor pagination for the Guest Manager REST API.

Jeff Blake
Written by Jeff Blake Updated May 28, 2026

The Guest Manager REST API lets you read and manage attendees, tickets, orders, events, and campaigns — for pulling data into CRMs, BI tools, and automation platforms like Make or Zapier. Full reference docs are at https://api.guestmanager.com. The API is available on every plan — no upgrade required.

Authentication

Pass your API token in the Authorization header. Both Token and Bearer prefixes work:

Authorization: Token <your_api_token>

Key endpoints

Endpoint Use
GET /api/public/v2/tickets Attendee list, check-in status, custom field responses
GET /api/public/v2/orders Orders, with the same filtering as tickets
GET /api/public/v2/events?include=campaigns Events with associated campaign IDs
PATCH /api/public/v2/campaigns/{id} Update a campaign’s email template

See the full reference for the complete endpoint catalog, including event creation and registration-type writes.

Filtering

Filter tickets by event:

filter[event_ids]=1234

Freeform search (name, email, barcode) — works on /tickets and /orders:

filter[search]=email@example.com

Pull the Shopify order number from a ticket — pass both include directives, comma-separated:

?include=line_item,line_item.order

The Shopify order number is then at line_item.order.number.

Pagination

The API uses cursor-based pagination. Pass page[cursor] (start with an empty cursor) and an optional page[size] (default 10):

?page[cursor]=&page[size]=50

Each response carries the next cursor and a ready-to-use link in meta:

"meta": {
  "page": { "size": 50, "next_cursor": "<token>", "last": false },
  "links": { "next": "https://api.guestmanager.com/api/public/v2/tickets?page[cursor]=<token>&page[size]=50" }
}

Follow meta.links.next (or pass next_cursor back as page[cursor]) to fetch the next page. When meta.page.last is true, you’ve reached the end.

Prices

registration_type.price is returned in dollars (the major currency unit), not cents.

Common errors

401 — Access Denied: Check that your Authorization header carries a valid token (Token <value> or Bearer <value>) for the correct account.

422 — duplicate barcode: Barcodes must be unique. The uniqueness scope (per-event vs. account-wide) is configurable at Settings → Company.

400 — invalid page parameter: Pass page in bracketed form (e.g. page[cursor]), not a flat ?page=2.

FAQ

Where is the barcode/QR code data? Barcodes are not stored in Shopify metafields. Read them from GET /api/public/v2/tickets, or export from Guest Manager: Events → your event → Manage in backend → Attendees → Export to CSV.

How do I update a campaign’s email template via API? First call GET /api/public/v2/events?include=campaigns to retrieve campaign IDs, then PATCH /api/public/v2/campaigns/{id} with {"campaign": {"email_template_id": <id>}}.

How do I get a total attendee count? Cursor pagination doesn’t return a grand total. For an exact count, open the Attendees list in the Guest Manager backend (Events → your event → Manage in backend → Attendees), where the count is shown and you can export the full list to CSV.

Is a white-label or enterprise API available? No — that offering is no longer available. </content>