BetterTicketsAPI Docs

Events

Get one event

GET/events/{id}
Scope
events:read
Base URL
https://app.bettertickets.com/api/partner/v1
Auth
Bearer API key

One event of your account, by numeric id or concert_sku. Answers 404 event_not_found for events of other accounts, test events, and events whose sales have closed (inactive, off sale, or past their sales cutoff).

locations lists every ticket type of the event, including ones that are switched off. Sell from GET /events/{id}/locations instead.

#Request

Headers

NameTypeRequiredDescription
AuthorizationstringrequiredBearer <key>. A btk_live_… or btk_test_… key.

Path parameters

NameTypeRequiredDescription
idstringrequiredNumeric event id, or the event's concert_sku (2–80 characters, matched case-insensitively). (min length 1, max length 80) Example: 1001

#Responses

StatusMeaningError codes
200The event.—
400The reference is neither a number nor a valid concert_sku (for example it contains /).invalid_event_id
401No key, or the key was checked and is unknown, revoked, expired or has the wrong prefix. The same invalid_api_key is returned for every kind of bad key. Do not retry it. A temporary problem checking the key answers 503 auth_unavailable instead. Repeated requests with a missing or invalid key from one IP address are answered 429 partner_rate_limited instead of 401.missing_api_key invalid_api_key
403The key lacks the required scope, or API access is off for the account.insufficient_scope partner_api_disabled
404No such event on your account, a test event, or an event whose sales have closed.event_not_found
405The HTTP method is not supported on this path.method_not_allowed
409The concert_sku matches more than one event on your account. Use the numeric id.ambiguous_concert_sku
429Too many requests from this key or from your IP address, or repeated requests with a missing or invalid key from one IP address (answered 429 instead of 401). Wait Retry-After seconds. See Rate Limits.partner_rate_limited
502BetterTickets could not load the data. Retry later.upstream_error
503BetterTickets could not check the key (auth_unavailable) or confirm the account's settings (FEATURE_GATE_UNAVAILABLE) for a moment. Safe to retry after Retry-After seconds; if the header is missing, wait 5 seconds. Retrying auth_unavailable faster than Retry-After gets 429 partner_rate_limited.auth_unavailable FEATURE_GATE_UNAVAILABLE

200 The event.

Schema: Event

One event, as returned by GET /events/{id}. Only the fields below are documented. Responses can contain other fields; they are not part of the API, may change or disappear without notice, and must not be relied on.

  • idintegerrequired

    Event id.

  • namestring | null
  • artiststring | null

    Headliner or display title.

  • datestring | null

    Event date, typically YYYY-MM-DD.

  • absolute_timestring | null

    Event start time as entered (typically ISO 8601).

  • doors_timestring | null
  • concert_skustring | null

    The event's reference code.

  • venue_idinteger | null
  • venue_stringstring | null

    Venue name as text.

  • venueVenue | null
    Child attributes
    • idinteger
    • namestring | null
    • addressstring | null
    • citystring | null
    • statestring | null
    • zip_codestring | null
    • timezonestring | null

      IANA time zone name, e.g. America/Chicago, when set.

  • event_image_urlstring | null
  • is_sold_outboolean

    True when the event is marked sold out or every active ticket type is sold out.

  • low_ticket_warningboolean

    True when any active ticket type is low.

  • locationsarray of EventTicketType

    Every ticket type of the event, including ones switched off (is_active: false) and ones not sold on their own, sorted by name. Sell from GET /events/{id}/locations, not from this list.

    Child attributes
    • idintegerrequired

      Ticket type (location) id.

    • event_idinteger
    • namestring | null
    • descriptionstring | null
    • priceinteger

      Price per ticket, in cents.

    • available_quantityinteger

      Tickets left; -1 = unlimited.

    • is_sold_outboolean
    • low_ticket_warningboolean

      True when only a few tickets are left.

    • is_activeboolean | null

      False for a ticket type that is switched off.

Example: event

JSON
{
  "id": 1001,
  "name": "Summer Roots Festival 2027",
  "artist": "Summer Roots Festival 2027",
  "date": "2027-07-16",
  "absolute_time": "2027-07-16T16:00:00-05:00",
  "doors_time": "3:00 PM",
  "concert_sku": "SRF_07-16-2027",
  "venue_id": 3001,
  "venue_string": "Riverside Park Bandshell",
  "venue": {
    "id": 3001,
    "name": "Riverside Park Bandshell",
    "address": "100 Example Ave",
    "city": "Springfield",
    "state": "IL",
    "zip_code": "62701",
    "timezone": "America/Chicago"
  },
  "event_image_url": "https://example.com/images/summer-roots.jpg",
  "is_sold_out": false,
  "low_ticket_warning": false,
  "locations": [
    {
      "id": 2001,
      "event_id": 1001,
      "name": "GA Weekend",
      "description": "General admission, both days.",
      "price": 5000,
      "available_quantity": 1188,
      "is_sold_out": false,
      "low_ticket_warning": false,
      "is_active": true
    }
  ]
}
400 The reference is neither a number nor a valid concert_sku (for example it contains /).

Schema: Error

Example: invalid_event_id

JSON
{
  "error": "invalid_event_id"
}
401 No key, or the key was checked and is unknown, revoked, expired or has the wrong prefix. The same invalid_api_key is returned for every kind of bad key. Do not retry it. A temporary problem checking the key answers 503 auth_unavailable instead. Repeated requests with a missing or invalid key from one IP address are answered 429 partner_rate_limited instead of 401.

Schema: Error

Example: missing_api_key

JSON
{
  "error": "missing_api_key",
  "message": "Authorization: Bearer btk_… required"
}

Example: invalid_api_key

JSON
{
  "error": "invalid_api_key"
}
403 The key lacks the required scope, or API access is off for the account.

Schema: Error

Example: insufficient_scope

JSON
{
  "error": "insufficient_scope",
  "required": "events:read"
}

Example: partner_api_disabled

JSON
{
  "error": "partner_api_disabled"
}
404 No such event on your account, a test event, or an event whose sales have closed.

Schema: Error

Example: event_not_found

JSON
{
  "error": "event_not_found"
}
405 The HTTP method is not supported on this path.

Schema: Error

Example: method_not_allowed

JSON
{
  "error": "method_not_allowed"
}
409 The concert_sku matches more than one event on your account. Use the numeric id.

Schema: Error

Example: ambiguous_concert_sku

JSON
{
  "error": "ambiguous_concert_sku"
}
429 Too many requests from this key or from your IP address, or repeated requests with a missing or invalid key from one IP address (answered 429 instead of 401). Wait Retry-After seconds. See Rate Limits.

Headers

NameTypeDescription
Retry-AfterintegerSeconds to wait before retrying (at least 1).

Schema: Error

Example: partner_rate_limited

JSON
{
  "error": "partner_rate_limited",
  "message": "Too many Partner API requests. Slow down and retry after Retry-After seconds.",
  "retry_after_seconds": 42
}
502 BetterTickets could not load the data. Retry later.

Schema: Error

Example: upstream_error

JSON
{
  "error": "upstream_error"
}
503 BetterTickets could not check the key (auth_unavailable) or confirm the account's settings (FEATURE_GATE_UNAVAILABLE) for a moment. Safe to retry after Retry-After seconds; if the header is missing, wait 5 seconds. Retrying auth_unavailable faster than Retry-After gets 429 partner_rate_limited.

Headers

NameTypeDescription
Retry-AfterintegerSeconds to wait before retrying.

Schema: Error

Example: auth_unavailable

JSON
{
  "error": "auth_unavailable",
  "message": "API key check is temporarily unavailable. Retry after Retry-After seconds.",
  "retryable": true,
  "retry_after_seconds": 5
}

Example: FEATURE_GATE_UNAVAILABLE

JSON
{
  "error": "FEATURE_GATE_UNAVAILABLE",
  "retryable": true,
  "retry_after_seconds": 5
}

#Code samples

Set BETTERTICKETS_API_KEY on your server. Never send a key from a browser.

cURL
curl "https://app.bettertickets.com/api/partner/v1/events/1001" \
  -H "Authorization: Bearer $BETTERTICKETS_API_KEY"