Speakers API

Overview

The Speakers API allows you to manage speakers for your events. You can create speakers, update their information, filter by status, and more.

Endpoints

List speakers

Get a paginated list of speakers for an event with optional filtering by status, tags, and search query.

Query parameters

Example request

curl -X GET "https://eventnerds.com/api/developer/v1/speakers?event_id=EVENT_ID&status=confirmed" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "event_id": "uuid",
      "email": "speaker@example.com",
      "name": "Jane Doe",
      "title": "Senior Developer",
      "company": "Tech Corp",
      "bio": "Experienced software engineer",
      "status": "confirmed",
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T10:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "totalPages": 3
  }
}

Create speaker

Create a new speaker or update existing speaker if email exists.

Request body

Example request

curl -X POST "https://eventnerds.com/api/developer/v1/speakers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "EVENT_ID",
    "email": "speaker@example.com",
    "name": "Jane Doe",
    "title": "Senior Developer",
    "company": "Tech Corp",
    "bio": "Experienced software engineer",
    "status": "confirmed"
  }'

Update speaker

Update speaker details. Only provided fields will be updated.

Example request

curl -X PATCH "https://eventnerds.com/api/developer/v1/speakers/SPEAKER_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "checked_in"
  }'

Delete speaker

Delete a speaker. This action cannot be undone.