Exploring the API

The Eventbrite API includes an API Explorer, a tool that helps you explore and debug Eventbrite endpoints. Detailed information on an endpoint is displayed in the API Explorer Web browser.

Using the following two endpoints, examples of using the API Explorer are provided: /users/me/ Shows information about the current user (i.e. you). /users/me/events Displays a list of Events you can manage.

Note: All available Eventbrite endpoints are described in the API Reference.

Example 1: Exploring the users/me/ Endpoint

To retrieve information about the current user, go to https://www.eventbriteapi.com/v3/users/me/?token=MYTOKEN

Make sure you replace MYTOKEN with your personal OAUTH token.

The initial response returned from /users/me/ is a single User object of the current user (i.e. you), displaying the following information:

• Details on the requested parameters.
• Token and user identification.
• Headers and status code of the response.
• Full JSON response, with the syntax highlighted and with clickable links to other endpoints if they’re included in the response.

The response looks something like

{
  "emails": [
    {
      "email": "andrewgodwin@eventbrite.com",
      "verified": false,
      "primary": true
    }
  ],
  "id": 85329145958,
  "name": "Andrew Godwin",
  "first_name": "Andrew",
  "last_name": "Godwin"
}

which is a paginated response of your User information.

Example 2: Exploring the users/me/owned_events Endpoint

Before trying this example, you must have created at least one Eventbrite Event (for information on creating an Event, refer to Create an Event).

To retrieve information about the Events you manage, point your browser to https://www.eventbriteapi.com/v3/users/me/events/?token=MYTOKEN Make sure you replace MYTOKEN with your personal OAUTH token.

The response is similar to:

{
  "pagination": {
    "object_count": 1,
    "page_number": 1,
    "page_size": 50,
    "page_count": 1
  },
  "events": [
    {
      "resource_uri": "https://www.eventbriteapi.com/v3/events/10067458038/",
      "name": {
        "text": "Test Event 1",
        "html": "Test Event 1"
      },
      "description": {
        "text": null,
        "html": null
      },
      "organizer": {
        "description": {
          "text": "An organizer",
          "html": "<P>An organizer</P>"
        },
        "id": 5867211989,
        "name": "Andrew's Amazing Conferences"
      },
      "venue": null,
      "ticket_classes": [
        {
          "id": 22717678,
          "name": "Standard Entry",
          "cost": "54.11",
          "fee": "3.97",
          "currency": "USD",
          "free": false,
          "minimum_quantity": 1,
          "maximum_quantity": null,
          "quantity_total": 100,
          "quantity_sold": 1,
          "sales_start": null,
          "sales_end": "2014-02-22T18:00:00Z"
        }
      ],
      "id": 10067458038,
      "url": "http://www.eventbrite.com/e/test-event-1-tickets-10067458038",
      "start": "2014-02-22T19:00:00Z",
      "end": "2014-02-22T22:00:00Z",
      "created": "2014-01-13T06:25:19Z",
      "changed": "2014-01-14T03:15:50Z",
      "timezone": "America/Los_Angeles",
      "capacity": 100,
      "categories": [],
      "status": "live"
    }
  ]
}

which is a paginated response of all your Events.