Usage details for a single month

Rate limits

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

Report with number of used seats in a certain month. The numbers are aggregated per workspace, per chart and per event.

The numUsedObjects property represents the number of 'used' (i.e. billable) seats.

Note

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

GET /reports/usage/month/{month}

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

[
  {
    workspace: 3432427,
    usageByChart: [
      {
        chart: {
          name: "My venue",
          key: "8303dc3f-c3b7-4416-973b-631057d311de"
        },
        usageByEvent: [
          {
            event: {id: 12, key: "AA3334"},
            numUsedObjects: 163
          }
        ]
      }
    ]
  },  
  {
    workspace: 3432428,
    usageByChart: [
      {
        chart: {
          name: "Super Dome",
          key: "0303dc3f-c3b7-4416-973b-631057d311de"
        },
        usageByEvent: [
          {
            event: {id: 125121, key: "E350804"},
            numUsedObjects: 163
          },
          {
            event: {id: 125122, key: "E350305"},
            numUsedObjects: 63
          }
        ]
      },
      {
        chart: {
          name: "Another Super Dome",
          key: "6303dc3f-c3b7-4416-973b-631057d311df"
        },
        usageByEvent: [
          {
            event: {id: 1251, key: "E350204"},
            numUsedObjects: 1
          }
        ]
      }
    ]
  }
]