Skip to main content

Usage details for event in month

Rate limits

This endpoint does not belong to the priority lane. Do not use it within your ticket sales flow.

Report with used seats for an event in a month.

Note

You need to authenticate with your company admin key for this API call.

GET /reports/usage/month/{month}/event/{eventId}
Event ID

This requires the event ID, not the event key. You first need to retrieve the event key.

New format (reports from December 2022)​

E.g. /reports/usage/month/2022-12/event/32429

[
    {
        "object": "A-1",
        "numUsedObjects": 1,
        "usageByReason": {
            "STATUS_CHANGED": 1
        }
    },
    {
        "object": "A-2",
        "numUsedObjects": 1,
        "usageByReason": {
            "SELECTED": 1
        }
    },
    {
        "object": "Standing",
        "numUsedObjects": 5,
        "usageByReason": {
            "STATUS_CHANGED": 1,
            "SELECTED": 2,
            "ASSIGNED_TO_CHANNEL": 2
        }
    }
]

Old format (reports up to November 2022)​

E.g. /reports/usage/month/2018-09/event/32429

[
    {
        "object": "A-1",
        "numFirstBookings": 1,
        "firstBookingDate": "2018-09-13T00:16:43.176Z",
        "numFirstSelections": 0,
        "numFirstBookingsOrSelections": 1
    },
    {
        "object": "A-2",
        "numFirstBookings": 0,
        "firstBookingDate": "2018-09-13T00:16:43.176Z",
        "numFirstSelections": 1,
        "numFirstBookingsOrSelections": 1
    },
    {
        "object": "Standing",
        "numFirstBookings": 34,
        "numFirstSelections": 56,
        "numFirstBookingsOrSelections": 56
    }
]