> ## Documentation Index > Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Concerts > Lists a metro's upcoming concerts that a cancellation market can still be created for, soonest first, 50 to a page and at most 20 pages. Narrow the dates to reach later shows. Each concert carries the `jambase_event_id` and `scheduled_date` that `POST /concert_cancellation_markets` takes, and the event and market tickers it has or would get for each offered cover. A ticker listed here names a market that may not exist yet: create it before sending an RFQ. Dates and times are local to the venue. ## OpenAPI ````yaml /openapi.yaml get /concert_cancellation_markets/concerts openapi: 3.0.0 info: title: Kalshi Trade API Manual Endpoints version: 3.36.0 description: >- Manually defined OpenAPI spec for endpoints being migrated to spec-first approach servers: - url: https://external-api.kalshi.com/trade-api/v2 description: Production Trade API server - url: https://api.elections.kalshi.com/trade-api/v2 description: Production shared API server, also supported - url: https://external-api.demo.kalshi.co/trade-api/v2 description: Demo Trade API server - url: https://demo-api.kalshi.co/trade-api/v2 description: Demo shared API server, also supported security: [] tags: - name: api-keys description: API key management endpoints - name: orders description: Order management endpoints - name: order-groups description: Order group management endpoints - name: portfolio description: Portfolio and balance information endpoints - name: communications description: Request-for-quote (RFQ) endpoints - name: multivariate description: Multivariate event collection endpoints - name: exchange description: Exchange status and information endpoints - name: live-data description: Live data endpoints - name: markets description: Market data endpoints - name: milestone description: Milestone endpoints - name: search description: Search and filtering endpoints - name: incentive-programs description: Incentive program endpoints - name: fcm description: FCM member specific endpoints - name: events description: Event endpoints - name: structured-targets description: Structured targets endpoints paths: /concert_cancellation_markets/concerts: get: tags: - markets summary: Get Concerts description: | Lists a metro's upcoming concerts that a cancellation market can still be created for, soonest first, 50 to a page and at most 20 pages. Narrow the dates to reach later shows. Each concert carries the `jambase_event_id` and `scheduled_date` that `POST /concert_cancellation_markets` takes, and the event and market tickers it has or would get for each offered cover. A ticker listed here names a market that may not exist yet: create it before sending an RFQ. Dates and times are local to the venue. operationId: GetConcerts parameters: - name: metro_id in: query required: true description: >- One of the metros from `GET /concert_cancellation_markets/availability`, such as `jambase:1`. schema: type: string x-oapi-codegen-extra-tags: validate: required - name: date_from in: query required: false description: >- List shows from this venue-local date, as YYYY-MM-DD. Omitted, or a date that has passed, lists from today. Pages count from it. schema: type: string x-oapi-codegen-extra-tags: validate: omitempty,datetime=2006-01-02 - name: date_to in: query required: false description: >- List shows up to this venue-local date, inclusive, as YYYY-MM-DD. Must not be before `date_from`. Omitted for no end. schema: type: string x-oapi-codegen-extra-tags: validate: omitempty,datetime=2006-01-02 - name: page in: query required: false description: Page to return, starting at 1. schema: type: integer format: int32 minimum: 1 maximum: 20 default: 1 x-oapi-codegen-extra-tags: validate: omitempty,min=1,max=20 responses: '200': description: Concerts retrieved successfully content: application/json: schema: $ref: '#/components/schemas/GetConcertsResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitError' '500': $ref: '#/components/responses/InternalServerError' security: - kalshiAccessKey: [] kalshiAccessSignature: [] kalshiAccessTimestamp: [] components: schemas: GetConcertsResponse: type: object required: - concerts - page - total_pages properties: concerts: type: array items: $ref: '#/components/schemas/Concert' page: type: integer format: int32 description: The page returned. total_pages: type: integer format: int32 description: Pages available for this metro and these dates. x-omitempty: false Concert: type: object required: - jambase_event_id - name - lineup - venue_name - timezone - scheduled_date - markets properties: jambase_event_id: type: string description: The show's id, as `jambase:`. example: jambase:16543035 name: type: string description: The show's name as listed. headliner: type: string description: The top-billed act. Left out when the listing names none. lineup: type: array items: type: string description: The acts on the bill, in billing order. venue_name: type: string description: The venue's name. city: type: string description: The venue's city. region: type: string description: The venue's state or region. country: type: string description: The venue's country code. timezone: type: string description: >- IANA time zone of the venue, which `scheduled_date` and `start_time` are local to. example: America/New_York scheduled_date: type: string description: The venue-local date the show is scheduled for, as YYYY-MM-DD. example: '2026-11-20' start_time: type: string description: >- Venue-local start time with no UTC offset, as YYYY-MM-DDTHH:MM:SS. Left out while only the date is announced. example: '2026-11-20T20:00:00' latitude: type: number format: double description: Latitude of the venue. Left out when unknown. longitude: type: number format: double description: Longitude of the venue. Left out when unknown. url: type: string description: The show's listing page. markets: type: array items: $ref: '#/components/schemas/ConcertMarket' description: One entry per offered cover. ErrorResponse: type: object properties: code: type: string description: Error code message: type: string description: Human-readable error message details: type: string description: Additional details about the error, if available ConcertMarket: type: object required: - cover - event_ticker - market_ticker properties: cover: $ref: '#/components/schemas/ConcertCover' event_ticker: type: string description: Event ticker the show has or would get for this cover. market_ticker: type: string description: >- Market ticker the show has or would get for this cover. The market may not exist yet. ConcertCover: type: string enum: - postponed - cancelled - either x-enum-varnames: - ConcertCoverPostponed - ConcertCoverCancelled - ConcertCoverEither description: | What a concert cancellation market pays on, read from the show's listing after its scheduled date has ended: - `postponed`: Yes when the show is listed as postponed, or as taking place on any other date. A show listed as canceled resolves to No. - `cancelled`: Yes when the show is listed as canceled. - `either`: Yes in both of those cases. responses: BadRequestError: description: Bad request - invalid input content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnauthorizedError: description: Unauthorized - authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ConflictError: description: Conflict - resource already exists or cannot be modified content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimitError: description: >- Rate limit exceeded. The default cost is 10 tokens per request. Use GET /trade-api/v2/account/endpoint_costs to list non-default endpoint costs. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: kalshiAccessKey: type: apiKey in: header name: KALSHI-ACCESS-KEY description: Your API key ID kalshiAccessSignature: type: apiKey in: header name: KALSHI-ACCESS-SIGNATURE description: >- Base64 signature of the pre-sign text (timestamp + method + path) made with the API key's algorithm - RSA-PSS with SHA-256 for RSA keys, Ed25519 for Ed25519 keys kalshiAccessTimestamp: type: apiKey in: header name: KALSHI-ACCESS-TIMESTAMP description: Request timestamp in milliseconds ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.