Listings / Index

Name	Listings Index
Description	Lists all listings for an event
Type	`GET`
URL	`/v9/listings`
Credential Type	`APICredential\|UserCredential`
Supports Pagination	No

Long Description

Returns all listings for the given event_id. This endpoint does not support pagination—all listings matching your query will be returned.

Please review our information on placing Test Orders in our Sandbox environment.

Each Listing in the response will include an available_quantity property, which indicates how many tickets are currently available to sell.

The splits array shows which quantities are available to purchase. For example, in splits:[1,2,3,4,5,7] an attempt to purchase 6 tickets will fail.

Seating Charts

Ticket Evolution’s dynamic seating charts are included and can be used via our Javascript client.

Parameters

Name	Description	Value Type	Required

Name	Description	Value Type	Required
`event_id`	ID of the Event for which you would like to get listings	Integer	Required
`type`	Filter by type to specify what types of tickets you will receive for an event: `event` `parking`	String	Optional
`quantity`	Filter by number of tickets greater than or equal to the passed value	integer	Optional
`section`	Filter by exact match section	String	Optional
`row`	Filter by exact match row	String	Optional
`owned`	Filter by your own listings. Setting this to `true` will return only ticket groups owned by any of the offices belonging to the same Brokerage as the requester.	Boolean	Optional
`order_by`	Sort results by any of the following parameters: `retail_price` `section` `row` `format` Adjust the sort direction by appending `ASC` or `DESC.` e.g.: `order_by=retail_price+DESC`	String	Optional

Response Properties

See Listings / Show for an explanation of the properties for each ticket group object.

Examples

Request	Response

Request

Response

Example of a request /v9/listings?event_id=1443642

{
  "total_entries": 11,
  "ticket_groups": [
    {
      "automated": true,
      "available_quantity": 4,
      "discounted": true,
      "eticket": true,
      "featured": false,
      "format": "TM_mobile",
      "id": 1904202811,
      "in_hand": false,
      "in_hand_on": "2023-07-28",
      "instant_delivery": false,
      "owned": false,
      "public_notes": "Orders for these tickets will be remain pending. Scan your tickets from your mobile phone for this event.",
      "quantity": 4,
      "retail_price": 52.54,
      "retail_price_inclusive": 52.54,
      "row": "GA",
      "section": "GAFLR",
      "service_fee": 0,
      "splits": [
        1,
        2,
        4
      ],
      "tevo_section_name": "gaflr",
      "type": "event",
      "view_type": null,
      "wheelchair": false,
      "wholesale_price": 52.54,
      "face_value": null,
      "seller_cost": null
    },
  ]
}