Publisher API

This API endpoint returns an array of event data in JSON format. An event has the following fields:

Response fields

By default a maximum of 20 records are returned.

Filters can be applied to narrow down the result set.

By default only evvnt-sourced events are returned, mirroring the original Marketing API. Pass all_sources=true to include events from all sources.

Query parameters

An empty array will be returned if no events match the filter set.

Example response

curl -X GET -H "Accept: application/json" -u API_KEY:API_SECRET https://api.evvnt.com/events?some_filters...
[
  {
    "id": "12345",
    "title": "The Event Title",
    "capacity": 100,
    "category_id": 17,
    "sub_category_ids": [],
    "timestamp": "2013-02-07T17:35:22Z",
    "start_time": "2013-02-23T22:00:00Z",
    "end_time": "2013-02-24T03:00:00Z",
    "summary": "This is an example event summary…",
    "description": "This is the complete event description…",
    "image_urls": ["http://example.com/the_url_of_the_image_associated_with_the_event"],
    "organiser_name": "John Smith Event Organisers Ltd",
    "contact": { "name": "John Smith", "email": "johnsmith@example.com", "tel": "020 1111 2222" },
    "venue": { "id": "15", "name": "Venue name", "country": "GB", "latitude": 52.1234, "longitude": -0.5678 },
    "links": { "Website": "https://go.evvnt.com/UUnkit" },
    "prices": { "price 1": "GBP 3.5" },
    "artists": "Richard Green, Groucho Marx",
    "keywords": "Example, event, keywords",
    "hashtag": "event2013"
  }
]

Returns a single event which matches :event_id in the same format as GET /events. Returns a 404 if a matching event is not found.

:event_id is the event's Discovery ID — a numeric id with an optional single-letter source suffix (e.g. 12345 for evvnt-sourced events, 67890x for other sources), exactly as returned in the id field.

Example return packet

curl -X GET -H "Accept: application/json" -u API_KEY:API_SECRET https://api.evvnt.com/events/67890x
{
  "id": "67890x",
  "title": "The Event Title",
  "capacity": 100,
  "category_id": 17,
  "sub_category_ids": [22, 23],
  "timestamp": "2013-02-07T17:35:22Z",
  "start_time": "2013-02-23T22:00:00Z",
  "end_time": "2013-02-24T03:00:00Z",
  "summary": "This is an example event summary…",
  "description": "This is the complete event description…",
  "image_urls" : ["http://example.com/the_url_of_the_image_associated_with_the_event"],
  "organiser_name": "John Smith Event Organisers Ltd",
  "contact" : { "name": "John Smith", "email": "johnsmith@example.com", "tel": "020 1111 2222" },
  "venue": { "id": "15", "name": "Venue name", "country": "Venue Country", "latitude": 52.1234, "longitude": -0.5678 },
  "links": { "Website": "https://go.evvnt.com/UUnkit" },
  "prices": { "price 1": "GBP 3.5", "price 2": "GBP 1.0" },
  "artists" : "Richard Green, Groucho Marx",
  "keywords" : "Example, event, keywords"
}

Returns the currently supported hierarchical list of categories and supported by evvnt.

There are no valid filters for this api call.

The format of a category record is as follows:

Example call

curl -X GET -H "Accept: application/json" -u API_KEY:API_SECRET https://api.evvnt.com/categories
[
  { "id": 126, "parent_id": 2,    "name": "Academic / Learning" },
  { "id": 49,  "parent_id": 48,   "name": "Accounting" },
  { "id": 96,  "parent_id": 95,   "name": "Agriculture" },
  { "id": 26,  "parent_id": null, "name": "All" },
  ....
]

This API endpoint returns an array of categories that a publisher is interested in. You can only find categories for publishers you have been given permission for.

Response fields

Query parameters

Example return request

curl -X GET -H "Accept: application/json" -u API_KEY:API_SECRET https://api.evvnt.com/publishers/324/categories?filter=direct
[
  { "id": 126, "parent_id": 2,    "name": "Academic / Learning" },
  { "id": 49,  "parent_id": 48,   "name": "Accounting" },
  { "id": 96,  "parent_id": 95,   "name": "Agriculture" },
  { "id": 26,  "parent_id": null, "name": "All" },
  ....
]

This API endpoint returns an array of published events belonging to a specific publisher. You can only find events for publishers you have been given permission for.

Response fields

An empty array will be returned if no upcoming published events exist for the publisher.

Query parameters

Example response

curl -X GET -H "Accept: application/json" -u API_KEY:API_SECRET https://api.evvnt.com/publishers/324/published_events/
[
  {
    "publisher_id": 324,
    "event_id": 1385,
    "url": 'http://suuperevents.example.com/events/3',
    "event_title": "Comedy Night",
    "event_start_time": "2024-05-10T15:00:00+01:00"
  }
]