Attendee Portal API

Overview

The Attendee Portal API provides endpoints for attendees to access their event information, update their profiles, and manage their tickets. This API uses magic link authentication instead of traditional API keys.

Endpoints

Request magic link

Request a magic link to be sent to an attendee's email. The attendee can click this link to authenticate and access their portal.

Example request

curl -X POST "https://eventnerds.com/api/developer/v1/attendee/auth/magic-link" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "attendee@example.com",
    "event_id": "EVENT_ID"
  }'

Response

{
  "success": true,
  "message": "Magic link sent to attendee@example.com"
}

Verify magic link

Verify a magic link token and receive an authentication token for accessing attendee portal endpoints.

Example request

curl -X POST "https://eventnerds.com/api/developer/v1/attendee/auth/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "MAGIC_LINK_TOKEN"
  }'

Response

{
  "success": true,
  "data": {
    "token": "ATTENDEE_AUTH_TOKEN",
    "attendee_id": "uuid",
    "event_id": "uuid"
  }
}

Get attendee profile

Get the authenticated attendee's profile information and event details.

Example request

curl -X GET "https://eventnerds.com/api/developer/v1/attendee/profile" \
  -H "Authorization: Bearer ATTENDEE_TOKEN"

Update attendee profile

Update the authenticated attendee's profile. Only certain fields can be updated by attendees.

Get attendee tickets

Get all tickets and orders for the authenticated attendee, including QR codes for check-in.