---
title: "Get Multivariate Event Collection"
method: GET
path: "/multivariate_event_collections/{collection_ticker}"
tags: ["multivariate"]
---

# Get Multivariate Event Collection

`GET /multivariate_event_collections/{collection_ticker}`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/multivariate_event_collections/{collection_ticker}`
- Auth: none declared

Endpoint for getting data about a multivariate event collection by its ticker.

## Path parameters

- `collection_ticker` string, required

## Response `200`

Collection retrieved successfully

- GetMultivariateEventCollectionResponse
  - `multivariate_contract` MultivariateEventCollection, required
    - `collection_ticker` string, required: Unique identifier for the collection.
    - `series_ticker` string, required: Series associated with the collection. Events produced in the collection will be associated with this series.
    - `exchange_index` integer: Identifier for an exchange shard.
    - `title` string, required: Title of the collection.
    - `description` string, required: Short description of the collection.
    - `open_date` string, date-time, required: The open date of the collection. Before this time, the collection cannot be interacted with.
    - `close_date` string, date-time, required: The close date of the collection. After this time, the collection cannot be interacted with.
    - `associated_events` AssociatedEvent[], required: List of events with their individual configuration.
      - `ticker` string, required: The event ticker.
      - `is_yes_only` boolean, required: Whether only the 'yes' side can be used for this event.
      - `size_max` integer, nullable: Maximum number of markets from this event (inclusive). Null means no limit.
      - `size_min` integer, nullable: Minimum number of markets from this event (inclusive). Null means no limit.
      - `active_quoters` string[], required: List of active quoters for this event.
    - `associated_event_tickers` string[], required: [DEPRECATED - Use associated_events instead] A list of events associated with the collection. Markets in these events can be passed as inputs to the Lookup and Create endpoints.
    - `is_ordered` boolean, required: Whether the collection is ordered. If true, the order of markets passed into Lookup/Create affects the output. If false, the order does not matter.
    - `is_single_market_per_event` boolean, required: [DEPRECATED - Use associated_events instead] Whether the collection accepts multiple markets from the same event passed into Lookup/Create.
    - `is_all_yes` boolean, required: [DEPRECATED - Use associated_events instead] Whether the collection requires that only the market side of 'yes' may be used.
    - `size_min` integer, required: The minimum number of markets that must be passed into Lookup/Create (inclusive).
    - `size_max` integer, required: The maximum number of markets that must be passed into Lookup/Create (inclusive).
    - `functional_description` string, required: A functional description of the collection describing how inputs affect the output.
    - `price_level_structure` string, required: Price level structure used for new markets created in this collection. Existing markets may differ; use the market's price_level_structure and price_ranges for its current pricing.
    - `price_ranges` PriceRange[], required: Price bands and tick sizes in fixed-point dollars for new markets created in this collection. Use these ranges to determine valid prices rather than hardcoding the structure name.
      - `start` string, required: Starting price for this range in dollars
      - `end` string, required: Ending price for this range in dollars
      - `step` string, required: Price step/tick size for this range in dollars

## Other responses

- `400`: Bad request - invalid input
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-10-06** `f93ce4d0bff2`: 2 info
  - added the required property `multivariate_contract/price_level_structure` to the response with the `200` status
  - added the required property `multivariate_contract/price_ranges` to the response with the `200` status
- **2026-08-04** `4cee66247882`: 1 info
  - added the optional property `multivariate_contract/exchange_index` to the response with the `200` status
- **2026-07-31** `a07481be8bf9`: 3 warning
  - removed the optional property `service` from the response with the `400` status
  - removed the optional property `service` from the response with the `404` status
  - removed the optional property `service` from the response with the `500` status
- **2025-12-02** `02c9ca7d135f`: 2 info
  - api tag `multivariate` added
  - api tag `collection` removed
- **2025-11-06** `6ad7527f54aa`: 2 breaking, 21 info
  - the response property `multivariate_contract/associated_events/items/size_max` became nullable for the status `200`
  - the response property `multivariate_contract/associated_events/items/size_min` became nullable for the status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - …19 more

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/multivariate_event_collections/:collection_ticker/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)