---
title: "GET /api/feed/v1/events/{eventId}/listings"
method: GET
path: "/api/feed/v1/events/{eventId}/listings"
tags: ["Feed"]
---

# GET /api/feed/v1/events/{eventId}/listings

`GET /api/feed/v1/events/{eventId}/listings`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/events/{eventId}/listings`
- Auth: HTTP bearer

## Path parameters

- `eventId` string, required

## Query parameters

- `source` 'vs' | 'sh' | 'sg' | 'tmr'
- `cursor` string

## Response `200`

The listings on sale for one event, one per row: source, section, row, quantity, the price per ticket before and after fees, face value, and when the listing last changed. 500 listings a page, ordered by source, section, row and price; follow meta.next_cursor for the rest; a cursor passed with another event or source is a 400. The first page fixes as_of and every page of the walk answers at that instant, so a listing that changes mid walk cannot move between pages. source narrows to one source code; sources lists every code the event has. section joins GET /v1/events/{eventId}/sections and GET /v1/events/{eventId}/section-map. No seller is named or identified, no upstream listing id is served, and no score is attached. An event with no listings answers an empty page. Compressed when the request accepts gzip. Costs ONE UNIT per page.

- FeedEventListings
  - `event_id` string, nullable, required
  - `source` 'vs' | 'sh' | 'sg' | 'tmr', nullable, required: The source asked for, or null for every source the event has.
  - `as_of` string, nullable, required: The instant these listings are rebuilt at: the newest observation of the event in the sources served. Every page of one walk answers at the same as_of. Null when the event has no listings.
  - `sources` string[], required: Every source code the event has listings on, whatever source was asked for.
  - `listings` FeedListing[], required: Ordered by source, section, row and price.
    - `source` 'vs' | 'sh' | 'sg' | 'tmr', required: The code of the source the listing is on.
    - `section` string, required: The section label a buyer reads. Where the section is in the event's catalog this is the key GET /v1/events/{eventId}/sections and GET /v1/events/{eventId}/section-map (sections[].section) use; otherwise it is the source's own label, which can be a ticket code that GET /v1/events/{eventId}/section-map carries as sections[].code.
    - `row` string, nullable, required: The row, as the listing states it. Null when it states none.
    - `quantity` integer, required: Tickets in the listing.
    - `price` number, nullable, required: Price per ticket before fees, in US dollars. Null when the source states only a price after fees.
    - `aip_price` number, nullable, required: Price per ticket after fees, in US dollars, as the source states it. Null when it states none.
    - `face_value` number, nullable, required: Face value per ticket, in US dollars, where the source states one.
    - `captured_at` string, required: When this listing was last observed to change: its price, quantity or section as served here.
  - `meta` object, required
    - `listings` integer, required: Listings in the whole walk, not only this page.
    - `returned` integer, required
    - `page_size` integer, required
    - `next_cursor` string, nullable, required: Pass as cursor for the next page. Null on the last page.
    - `units_charged` integer, required

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `404`: No such event.
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/findticker/apis/ticker-api.md) · [All operations](https://skmtc.dev/findticker/apis/ticker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findticker/apis/ticker-api/revisions/b6229ca924f4?raw)