What is the situation with eventbrite API documentation?

[Will Neild]

Hi there!

I am evaluating Eventbrite as a solution to integrate with for hosting private events but am a bit confused about the state of the documentation.

My first goal was to simply list the upcoming events associated with our account. Following https://www.eventbrite.com/platform/docs/events, a page linked from the landing page of creating an API key*, it references that to list events I should call

  curl -X GET https://www.eventbriteapi.com/v3/users/me/events?status=live -H 'Authorization: Bearer PERSONAL_OAUTH_TOKEN'

This returns:

{
  status_code: 404,
  error_description: 'The path you requested does not exist.',
  error: 'NOT_FOUND'
}

Searching around I have discovered user posts dating a year back that this is because this API endpoint was deprecated and that

https://www.eventbriteapi.com/v3/organizations/{organization_id}/events?status=live should now be used.

So before I delve deeper into working out integration Eventbrite I have a couple of questions:

1. Is this the latest documentation? https://www.eventbrite.com/platform/docs/introduction

2. Is this an actively managed and developed API?

3. If both the above are true I would like to understand why there are no deprecation warnings for something that was seemingly deprecated a year ago? And beyond that how has it then been removed and the documentation still references it today?

In general, can any existing devs speak to their experience integrating with this API up to now? Hopefully this is bad timing, but I'd have thought this would be a very visible issue given what I imagine is a very common operation.

Thanks,

Will

* https://www.eventbrite.com/platform/api-keys/?internal_ref=login

[Natalie Blikslager]

Hey Will,

Thanks for reaching out and sorry for the confusion you experienced. We really appreciate your feedback - we are working to update and improve our documentation and will keep this in mind!

The /v3/users/me/events/ endpoint has been deprecated, as we fully moved to an organizations structure on the platform and updated our API accordingly for compatibility in February 2020. We document changes and deprecations with our API in the Changelog here. 

This is the correct endpoint to use instead in your case: https://www.eventbriteapi.com/v3/organizations/{organization_id}/events/?status=live. For more information, check out our API Reference here: List Events by Organization.

Answers to your questions are below!

1. Is this the latest documentation? https://www.eventbrite.com/platform/docs/introduction

Yes, this is the latest documentation, though it requires updates that we are working to implement as soon as possible. Our API Reference here is most up to date and I recommend it as your primary Eventbrite API resource!

2. Is this an actively managed and developed API?

Yes.

3. If both the above are true I would like to understand why there are no deprecation warnings for something that was seemingly deprecated a year ago? And beyond that how has it then been removed and the documentation still references it today?

We do notify API users of deprecations/breaking changes via email in advance, as well as document them in our Changelog, but I can see how it makes for a confusing experience as a new user currently and sincerely apologize. The documentation around deprecated /v3/users/me/ endpoints is a top priority in the updates and improvements we are working to implement. 

I hope this is helpful as you work to build an integration with Eventbrite!

Thanks,

Natalie 

[Amandine Chapelle-Barry]

Hello,
What is the correct endpoint to use if we want to have a list of all events generated from any organization in Eventbride ?
Is there an endpoint where we don't need to enter a specific organization id ? What are the required header in that case ?
I tried several solutions found online, but I always have the error_description alert. I am trying to implement the API in GSheet.
Thank you.