API Reference

Introduction

The EventNerds Developer API provides comprehensive endpoints for managing events, speakers, sessions, sponsors, tickets, registrations, and attendee data. This API uses REST principles with JSON request and response formats.

All API endpoints are versioned and available at:

Authentication

Most API endpoints require authentication using an API key. Include your API key in the Authorization header of each request:

Quick start

Here is a simple example of making a request to the API to list speakers for an event:

curl -X GET "https://eventnerds.com/api/developer/v1/speakers?event_id=YOUR_EVENT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Replace YOUR_API_KEY with your actual API key and YOUR_EVENT_ID with the event ID you want to query.

Response format

All API responses follow a consistent JSON structure:

{
  "success": true,
  "data": { /* response data */ },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid event_id parameter",
    "details": { /* additional error information */ }
  }
}

Rate limiting

API requests are rate limited to ensure service reliability. Current rate limits are:

• Free Plan: 100 requests per hour
• Starter Plan: 1,000 requests per hour
• Pro Plan: 10,000 requests per hour
• Enterprise Plan: Custom rate limits

Rate limit information is included in response headers:

Pagination

List endpoints support pagination using the following query parameters:

• page - Page number (default: 1)
• limit - Items per page (default: 20, max: 100)
• sort - Field to sort by
• order - Sort order (asc or desc)

Example:

API categories

The EventNerds API is organized into the following categories. Click on a category to view all available endpoints:

Additional resources