> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# List or get series

> Retrieve series. Use `id` or `series_slug` for single lookup, `series_ids` or `series_slugs` (comma-separated, max 250, mutually exclusive) for multi-lookup, or paginate with `active_only`.



## OpenAPI

````yaml https://api.struct.to/openapi.json get /polymarket/series
openapi: 3.1.0
info:
  title: Polymarket API
  description: >-
    RESTful API for querying Polymarket prediction markets data including
    events, markets, traders, holders, and real-time metrics
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.struct.to/v1
security: []
paths:
  /polymarket/series:
    get:
      tags:
        - Series
      summary: List or get series
      description: >-
        Retrieve series. Use `id` or `series_slug` for single lookup,
        `series_ids` or `series_slugs` (comma-separated, max 250, mutually
        exclusive) for multi-lookup, or paginate with `active_only`.
      operationId: get_series_list
      parameters:
        - name: id
          in: query
          description: Single series ID for direct lookup
          required: false
          schema:
            type: string
        - name: series_ids
          in: query
          description: >-
            Comma-separated series IDs (max 250). Mutually exclusive with
            series_slugs.
          required: false
          schema:
            type: string
        - name: series_slugs
          in: query
          description: >-
            Comma-separated series slugs (max 250). Mutually exclusive with
            series_ids.
          required: false
          schema:
            type: string
        - name: active_only
          in: query
          description: >-
            Only active series (default: true). Ignored when series_ids or
            series_slugs are provided.
          required: false
          schema:
            type: boolean
        - name: limit
          in: query
          description: 'Results limit (default: 10, max: 250)'
          required: false
          schema:
            type: integer
            format: int32
        - name: pagination_key
          in: query
          description: 'Cursor for pagination: id of the last series from the previous page'
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Series or list of series
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PolymarketSeries'
        '400':
          description: series_ids and series_slugs cannot both be provided
components:
  schemas:
    PolymarketSeries:
      type: object
      description: |-
        A Polymarket series from the Gamma API
        Series are parent groupings above events (e.g., "NBA Season 2024-25")
      properties:
        id:
          type: string
          default: ''
        slug:
          type:
            - string
            - 'null'
          default: null
        ticker:
          type:
            - string
            - 'null'
          default: null
        title:
          type:
            - string
            - 'null'
          default: null
        description:
          type:
            - string
            - 'null'
          default: null
        series_type:
          type:
            - string
            - 'null'
          default: null
        recurrence:
          type:
            - string
            - 'null'
          default: null
        layout:
          type:
            - string
            - 'null'
          default: null
        image_url:
          type:
            - string
            - 'null'
          default: null
        icon_url:
          type:
            - string
            - 'null'
          default: null
        active:
          type: boolean
          default: false
        closed:
          type: boolean
          default: false
        archived:
          type: boolean
          default: false
        featured:
          type: boolean
          default: false
        restricted:
          type: boolean
          default: false
        pyth_token_id:
          type:
            - string
            - 'null'
          default: null
        cg_asset_name:
          type:
            - string
            - 'null'
          default: null
        start_date:
          type:
            - integer
            - 'null'
          format: int64
          default: null
        event_count:
          type: integer
          format: int32
          default: 0

````