Events

Resource description

The event resource contains the following public fields:

Field

Type

Description

name

multi-lingual string

The event’s full name

slug

string

A short form of the name, used e.g. in URLs.

is_public

boolean

If true, the event is publicly visible.

date_from

datetime

The event’s start date

date_to

datetime

The event’s end date (or null)

timezone

string

The event’s chosen time zone

urls

object

Contains URLs to relevant event pages. "base", "schedule", "login", and "feed" are guaranteed to be present.

New in version 1.1: The urls field.

Endpoints

GET /api/events/

Returns a list of all events the authenticated user/token has access to, or all public events for unauthenticated users.

Example request:

GET /api/events/ HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "name": {"en": "Sample Conference"},
      "slug": "sampleconf",
      "timezone": "Europe/berlin",
      "date_from": "2017-12-27T10:00:00Z",
      "date_to": null,
      "is_public": true,
      "urls": {
        "base": "https://…/sampleconf",
        "schedule": "https://…/sampleconf/schedule/",
        "login": "https://…/sampleconf/login/",
        "feed": "https://…/sampleconf/schedule/feed.xml",
      }
    }
  ]
}
Query Parameters
  • page – The page number in case of a multi-page result set, default is 1

GET /api/events/(event)/

Returns information on one event, identified by its slug.

Example request:

GET /api/events/sampleconf/ HTTP/1.1
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
   "name": {"en": "Sample Conference"},
   "slug": "sampleconf",
   "timezone": "Europe/berlin",
   "date_from": "2017-12-27T10:00:00Z",
   "date_to": null,
   "is_public": true,
   "urls": {
     "base": "https://…/sampleconf",
     "schedule": "https://…/sampleconf/schedule/",
     "login": "https://…/sampleconf/login/",
     "feed": "https://…/sampleconf/schedule/feed.xml",
   }
}
Parameters
  • event – The slug field of the event to fetch

Status Codes