Inventory Lookup

Description

Returns inventory listings for events by ticket agent. This endpoint allows you to retrieve current ticket inventory information for up to 10 events at once.

Request

GET /inventory/{ticketAgent}/{ids}

• Path Parameters:
  • ticketAgent (string, required): The ticket agent code (e.g., TMUSA, STUBHUB, SKYBOX, TICKETEVOLUTION).
  • ids (string, required): A single event ID or comma-delimited list of event IDs (maximum 10 IDs per request).

Supported Ticket Agents

The following ticket agent codes are supported:

• TMUSA - Ticketmaster USA
• STUBHUB - StubHub
• SKYBOX - Skybox
• TICKETEVOLUTION - Ticket Evolution
• SEATGEEK - SeatGeek
• VIVID - Vivid Seats
• TICKPICK - TickPick
• TICKETNETWORK - Ticket Network
• GAMETIME - GameTime

For a complete list of available agents, use the Get Available Services endpoint.

Response

• Status Code: 200 OK
• Content Type: application/json
• Response Body: Inventory data including available tickets, sections, rows, and pricing information.
• Possible Status Codes:
  • 200 OK: Successfully retrieved inventory data.
  • 400 Bad Request: Returned if more than 10 IDs are requested at once.
  • 404 Not Found: Returned if the ticket agent is not recognized or invalid.
  • 503 Service Unavailable: Returned if the inventory service is temporarily unavailable.

Examples

Single Event Lookup

GET /inventory/TMUSA/vvG1VZKS3n1Aso

Multiple Events Lookup

GET /inventory/STUBHUB/157158329,157158330,157158331

Response:

{
  "data": [
    {
      "eventId": "157158329",
      "ticketAgent": "STUBHUB",
      "sections": [
        {
          "section": "101",
          "row": "A",
          "quantity": 2,
          "price": 125.50,
          "listingId": "abc123"
        },
        {
          "section": "102",
          "row": "B",
          "quantity": 4,
          "price": 89.99,
          "listingId": "def456"
        }
      ]
    }
  ],
  "timestamp": "2025-01-15T14:30:00Z"
}

Notes

• The maximum number of event IDs per request is 10. Requests with more than 10 IDs will return a 400 Bad Request error.
• Event IDs should be the agent-specific identifiers (not Shows On Sale event IDs starting with evt_).
• Inventory data is typically refreshed every 15-30 minutes depending on the ticket agent.
• Response format and available fields may vary slightly by ticket agent.