> ## 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 an expansion

> One expansion, with its counts and legality.

Returns [the expansion object](/expansions/object). For what is inside it, see
[List cards](/cards/list) and [List products](/products/list), both with `expansion_id`.


## OpenAPI

````yaml openapi.json GET /v1/expansions/{id}
openapi: 3.0.0
info:
  title: Cromos API
  version: 1.0.0
servers:
  - url: https://api.cromos.so
security:
  - bearerAuth: []
paths:
  /v1/expansions/{id}:
    get:
      tags:
        - Expansions
      summary: Get an expansion
      description: >-
        One expansion, including its card counts and tournament legality.
        Returns 404 if no expansion carries the id.
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Expansion detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Expansion'
                  error:
                    type: object
                    nullable: true
                required:
                  - data
                  - error
              example:
                data:
                  id: sv03.5
                  series_id: sv
                  name: '151'
                  logo:
                    low: https://assets.cromos.so/expansions/sv03-5/logo/low.webp
                    high: https://assets.cromos.so/expansions/sv03-5/logo/high.webp
                  symbol: https://assets.cromos.so/expansions/sv03-5/symbol/image.webp
                  release_date: '2023-09-22'
                  card_count_total: 207
                  card_count_official: 165
                  legal_standard: false
                  legal_expanded: true
                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:
    Expansion:
      allOf:
        - $ref: '#/components/schemas/ExpansionSummary'
        - type: object
          properties:
            series_id:
              type: string
            card_count_official:
              type: number
              nullable: true
              description: The printed set size, which excludes secret rares.
            legal_standard:
              type: boolean
              nullable: true
            legal_expanded:
              type: boolean
              nullable: true
          required:
            - series_id
            - card_count_official
            - legal_standard
            - legal_expanded
    ErrorResponse:
      type: object
      properties:
        data:
          type: object
          nullable: true
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - data
        - error
    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

````