Back to Developers

API Documentation

Comprehensive API reference with examples, parameters, and response schemas.

Endpoints

Event Details

Get comprehensive event information including venue, sales, and details

GET
/api/v1/events/{event_id}

Parameters

ParameterTypeRequiredDescription
event_idstringYesThe Ticketmaster event ID
getSalesbooleanNoWhether to include sales information (default: true)

Authentication

All API requests require authentication using an API key in the x-api-key header.

x-api-key: YOUR_API_KEY

Example Request

curl -X GET "https://kage-app-QwnFlwdLxKnfuQ-tm-events-api.kageserver.app/api/v1/events/1700630C79FC0EC2" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "event": {
    "tm_id": "0C006283DD3E4EFA",
    "name": "Lil Wayne with Special Guests Hot Boys ",
    "start_time": "2025-09-22T21:00:00-04:00",
    "end_time": "0000-12-31T19:03:58-04:56",
    "status": "rescheduled",
    "url": "https://www.ticketmaster.com/lil-wayne-with-special-guests-hot-oklahoma-city-oklahoma-09-22-2025/event/0C006283DD3E4EFA",
    "image_url": "https://s1.ticketm.net/dam/a/2aa/481f0277-79b7-45db-bd74-aeea3c3e62aa_EVENT_DETAIL_PAGE_16_9.jpg",
    "currency": "USD",
    "genre": "Hip-Hop/Rap",
    "venue": {
      "name": "Paycom Center",
      "capacity": 19599,
      "street": "100 West Reno",
      "city": "Oklahoma City",
      "state": "Oklahoma",
      "country": "United States Of America"
    },
    "sales": {
      "public": {
        "start_date_time": "2025-04-11T11:00:00-04:00",
        "end_date_time": "2025-09-22T23:00:00-04:00"
      },
      "presales": [
        {
          "name": "Artist Presale",
          "start_date_time": "2025-04-09T13:00:00-04:00",
          "end_date_time": "2025-04-11T00:59:00-04:00",
          "visible": true
        },
        {
          "name": "Live Nation Presale",
          "start_date_time": "2025-04-09T13:00:00-04:00",
          "end_date_time": "2025-04-11T00:59:00-04:00",
          "visible": true
        },
        {
          "name": "Ticketmaster Presale",
          "start_date_time": "2025-04-09T13:00:00-04:00",
          "end_date_time": "2025-04-11T00:59:00-04:00",
          "visible": true
        },
        {
          "name": "Venue Presale",
          "start_date_time": "2025-04-09T13:00:00-04:00",
          "end_date_time": "2025-04-11T00:59:00-04:00",
          "visible": true
        },
        {
          "name": "Official Platinum Presale",
          "start_date_time": "2025-04-09T13:00:00-04:00",
          "end_date_time": "2025-04-11T00:59:00-04:00",
          "visible": true
        },
        {
          "name": "Official Platinum Onsale",
          "start_date_time": "2025-04-11T11:00:00-04:00",
          "end_date_time": "2025-05-16T11:00:00-04:00",
          "visible": true
        }
      ]
    },
    "details": {
      "stubhub": {
        "url": "https://www.stubhub.com/lil-wayne-oklahoma-city-tickets-5-16-2025/event/157836754/?qid=b0e0b4e9fff80422f896c09e68ae6d9f&iid=5090b711-8024-4c5c-b5b7-479665d02e8a&index=stubhub&ut=91b180ea5639a9b68f7c357a97c46cbf74265913",
        "relevent_id": "157836754"
      },
      "vivid_seats": {
        "url": "https://www.vividseats.com/lil-wayne-tickets-oklahoma-city-paycom-center-5-16-2025--concerts-rap-hip-hop/production/5684138",
        "relevent_id": "5684138",
        "low_price": 94,
        "high_price": 2057,
        "at_price": 176.88,
        "total_listings": 303,
        "total_seats": 2028
      }
    },
    "attraction": {
      "tm_id": "712214",
      "name": "Lil Wayne",
      "type": "attraction",
      "upcoming_events": 25,
      "url": "https://www.ticketmaster.com/lil-wayne-tickets/artist/712214",
      "seo_name": "lil-wayne-tickets",
      "seo_url": "/lil-wayne-tickets/artist/712214"
    },
    "inventory": {}
  }
}