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

# Get a series

> One series and every expansion inside it.

Returns [the series object](/series/object) with its expansions inline, ordered by release
date — one request to render a whole browse column.

Ids are short: `base`, `swsh`, `sv`. [List series](/series/list) if you do not have one.


## OpenAPI

````yaml openapi.json GET /v1/series/{id}
openapi: 3.0.0
info:
  title: Cromos API
  version: 1.0.0
servers:
  - url: https://api.cromos.so
security:
  - bearerAuth: []
paths:
  /v1/series/{id}:
    get:
      tags:
        - Series
      summary: Get a series
      description: >-
        One series with every expansion inside it, ordered by release date.
        Returns 404 if no series carries the id.
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Series detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/SeriesDetail'
                  error:
                    type: object
                    nullable: true
                required:
                  - data
                  - error
              example:
                data:
                  id: base
                  name: Base
                  logo:
                    low: https://assets.cromos.so/series/base/logo/low.webp
                    high: https://assets.cromos.so/series/base/logo/high.webp
                  expansions:
                    - id: base1
                      name: Base Set
                      logo:
                        low: https://assets.cromos.so/series/base/logo/low.webp
                        high: https://assets.cromos.so/series/base/logo/high.webp
                      symbol: null
                      release_date: '1999-01-09'
                      card_count_total: 102
                    - id: base2
                      name: Jungle
                      logo:
                        low: >-
                          https://assets.cromos.so/expansions/base2/logo/low.webp
                        high: >-
                          https://assets.cromos.so/expansions/base2/logo/high.webp
                      symbol: >-
                        https://assets.cromos.so/expansions/base2/symbol/image.webp
                      release_date: '1999-06-16'
                      card_count_total: 64
                    - id: basep
                      name: Wizards Black Star Promos
                      logo:
                        low: >-
                          https://assets.cromos.so/expansions/basep/logo/low.webp
                        high: >-
                          https://assets.cromos.so/expansions/basep/logo/high.webp
                      symbol: >-
                        https://assets.cromos.so/expansions/basep/symbol/image.webp
                      release_date: '1999-07-01'
                      card_count_total: 53
                    - id: wp
                      name: W Promotional
                      logo: null
                      symbol: null
                      release_date: '1999-09-01'
                      card_count_total: 7
                    - id: base3
                      name: Fossil
                      logo:
                        low: >-
                          https://assets.cromos.so/expansions/base3/logo/low.webp
                        high: >-
                          https://assets.cromos.so/expansions/base3/logo/high.webp
                      symbol: >-
                        https://assets.cromos.so/expansions/base3/symbol/image.webp
                      release_date: '1999-10-10'
                      card_count_total: 62
                    - id: base4
                      name: Base Set 2
                      logo:
                        low: >-
                          https://assets.cromos.so/expansions/base4/logo/low.webp
                        high: >-
                          https://assets.cromos.so/expansions/base4/logo/high.webp
                      symbol: >-
                        https://assets.cromos.so/expansions/base4/symbol/image.webp
                      release_date: '2000-02-24'
                      card_count_total: 130
                    - id: base5
                      name: Team Rocket
                      logo:
                        low: >-
                          https://assets.cromos.so/expansions/base5/logo/low.webp
                        high: >-
                          https://assets.cromos.so/expansions/base5/logo/high.webp
                      symbol: >-
                        https://assets.cromos.so/expansions/base5/symbol/image.webp
                      release_date: '2000-04-24'
                      card_count_total: 83
                error: null
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SeriesDetail:
      allOf:
        - $ref: '#/components/schemas/Series'
        - type: object
          properties:
            expansions:
              type: array
              items:
                $ref: '#/components/schemas/ExpansionSummary'
          required:
            - expansions
    ErrorResponse:
      type: object
      properties:
        data:
          type: object
          nullable: true
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - data
        - error
    Series:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        logo:
          $ref: '#/components/schemas/ImageUrls'
      required:
        - id
        - name
        - logo
    ExpansionSummary:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        logo:
          $ref: '#/components/schemas/ImageUrls'
        symbol:
          type: string
          nullable: true
          description: The expansion symbol, as a single rendition.
        release_date:
          type: string
          nullable: true
        card_count_total:
          type: number
          nullable: true
          description: Every card the expansion contains, secret rares included.
      required:
        - id
        - name
        - logo
        - symbol
        - release_date
        - card_count_total
    ApiError:
      type: object
      properties:
        code:
          type: string
          description: A stable machine-readable token. Switch on this, not on `message`.
        message:
          type: string
          description: A human-readable sentence. Always present, never empty.
      required:
        - code
        - message
    ImageUrls:
      type: object
      nullable: true
      properties:
        low:
          type: string
          format: uri
          description: Thumbnail-sized rendition. May be the same URL as `high`.
        high:
          type: string
          format: uri
          description: Full-sized rendition. May be the same URL as `low`.
      required:
        - low
        - high
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````