Get started

In order to use the Eventgoose API and all of its features, users need to authenticate themselves using an API token. Keep in This section will explain how to retreive an API token and use it to perform your first requests. Keep in mind: The API is limited to 200 requests per minute per token.

Step 1: Get your API Token

The first thing you need is an Eventgoose account and an organisation. Go to your organisation settings and generate an API token.

Of course it's very important to keep the API token secure. Never share your tokens. However, if a token leaks you can always regenerate it. Don't forget to apply the new token to your code, because the old token won't work anymore.

Step 2: Authenticating an API call

The API token must be sent along with each API request, by providing it in the HTTP call's Authorization header using the Bearer method. For example: a valid Authorization header is Bearer 52Yaizm2PvsCpgvHBZ332UVjYqPBMinqsTdO0crg

In the example below we use a API token on the GET method of the List events resource. This method fetches a list of events.

Response

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

{
    "data": [
        {
            "id": "jL3DYVM4ApEBJn4w",
            "name": "Golden Plains",
            "is_continuous": false,
            "dates": [
                {
                    "id": "5dP8kGOmLlEwgmlr",
                    "starts_at": "2020-12-18T17:00:00.000000Z",
                    "ends_at": "2020-12-18T22:30:00.000000Z"
                },
                {
                    "id": "oLenyp2qbDMRAQVY",
                    "starts_at": "2020-12-19T17:00:00.000000Z",
                    "ends_at": "2020-12-19T22:30:00.000000Z"
                }
            ],
            "venue": {
                "name": "Eventgoose: Online Tickets Verkopen",
                "street": "F.B. Deurvorststraat",
                "house_number": "43",
                "addition": null,
                "zipcode": "7071 BG",
                "city": "Ulft",
                "state": null,
                "country": "Netherlands"
            },
            "shops": [
                "a5KgQw2vqOPlAZJ9",
                "3Q4aZe21jMrlkY6x"
            ],
            "tickets": [
                {
                    "id": "3Q4aZe21N0MrlkY6",
                    "name": "Regular",
                    "price": "50.00",
                    "service_fee": 1,
                    "min_order_amount": 0,
                    "max_order_amount": 10,
                    "sold_out": true
                },
                {
                    "id": "0nqJjGEj3WOedYPQ",
                    "name": "VIP",
                    "price": "75.00",
                    "service_fee": 1,
                    "min_order_amount": 0,
                    "max_order_amount": 10,
                    "sold_out": true
                }
            ]
        },
        {  },
        {  },
    ],
    "links": {
        "first": "https://api.eventgoose.com/v1/events?page=1",
        "last": "https://api.eventgoose.com/v1/events?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.eventgoose.com/v1/events",
        "per_page": 20,
        "to": 3,
        "total": 3
    }
}