> ## Documentation Index > Fetch the complete documentation index at: https://docs.elestrals.com/llms.txt > Use this file to discover all available pages before exploring further. # List physical printings. > Cursor-paginated list of physical printings (one row per `Card`). Only printings whose set is publicly displayed are returned. ## OpenAPI ````yaml /openapi.yaml get /v1/printings openapi: 3.1.0 info: title: Elestrals TCG API summary: Public read-only API for Elestrals TCG card data. description: > Semi-public REST API exposing Elestrals TCG card data to approved developers. Access is gated by application and controlled by per-key rate limits. This file is the source of truth for the API's public contract. Code and spec stay in sync via the CI consistency check (see `scripts/check-openapi.mjs`). version: 1.0.0 contact: name: Elestrals Developer Support url: https://docs.elestrals.com license: name: Proprietary identifier: LicenseRef-Elestrals-Developer-Agreement servers: - url: https://api.elestrals.com description: Production - url: http://127.0.0.1:8787 description: Local wrangler dev security: - bearerAuth: [] tags: - name: Meta description: Service metadata endpoints. - name: Series description: Groupings of sets (First Edition, Kickstarter, Organized Play, etc.). - name: Sets description: Product sets (booster, starter deck, specialty). - name: Creatures description: The master creature lineage for Elestrals cards. - name: Cards description: Game entities — the cards as gameplay pieces (stats, effects, legality). - name: Printings description: Physical printings — a specific printed card in a set. paths: /v1/printings: get: tags: - Printings summary: List physical printings. description: | Cursor-paginated list of physical printings (one row per `Card`). Only printings whose set is publicly displayed are returned. operationId: listPrintings parameters: - $ref: '#/components/parameters/LimitQuery' - $ref: '#/components/parameters/CursorQuery' - $ref: '#/components/parameters/PrintingSort' - name: card_id in: query schema: type: string example: et-100 description: Filter to printings of a single card (Entity ID). - name: set_id in: query schema: type: string example: st-53 - name: series_id in: query schema: type: string example: sr-5 - name: rarity in: query style: form explode: true schema: type: array items: $ref: '#/components/schemas/Rarity' - name: condition in: query style: form explode: true schema: type: array items: $ref: '#/components/schemas/Condition' - name: canvas in: query style: form explode: true schema: type: array items: $ref: '#/components/schemas/Canvas' - name: frame_material in: query style: form explode: true schema: type: array items: $ref: '#/components/schemas/FrameMaterial' - name: name in: query schema: type: string description: Case-insensitive prefix match on the printing's name. - name: artist in: query schema: type: string description: Exact-match filter on artist name (case-insensitive). - name: updated_since in: query schema: type: string format: date-time - $ref: '#/components/parameters/BasePrintingQuery' responses: '200': description: Paginated list of printings. content: application/json: schema: $ref: '#/components/schemas/PrintingListResponse' '400': $ref: '#/components/responses/BadRequest' '500': $ref: '#/components/responses/InternalError' components: parameters: LimitQuery: name: limit in: query schema: type: integer minimum: 1 maximum: 250 default: 50 description: Page size, max 250. CursorQuery: name: cursor in: query schema: type: string description: >- Opaque pagination cursor from a previous response's `pagination.next_cursor`. PrintingSort: name: sort in: query schema: type: string enum: - set_number - '-set_number' - name - '-name' - release_date - '-release_date' - updated_at - '-updated_at' default: set_number description: Sort field. Prefix with `-` for descending. BasePrintingQuery: name: base_printing in: query schema: type: boolean description: >- Filter to / out the canonical printing of each Entity (the row whose Card.id matches Entity.base_card_id). Omit to return every printing. schemas: Rarity: type: string enum: - common - uncommon - rare - stellar_rare Condition: type: string enum: - normal - reverse_holo - holo - metal Canvas: type: string enum: - regular_art - full_art - borderless_art FrameMaterial: type: string enum: - stone - tablet - marble - black_marble - ethereal - crystal PrintingListResponse: type: object required: - data - pagination - meta properties: data: type: array items: $ref: '#/components/schemas/Printing' pagination: $ref: '#/components/schemas/Pagination' meta: $ref: '#/components/schemas/Meta' Printing: type: object required: - id - base_printing - name - set_number - sort_number - banlists - set - series - rarity - variants - canvas - frame_material - holo_pattern - artist - effect_current - effect_printed - entity - images - serialized - prize_card - updated_at properties: id: type: string example: cd-1000 base_printing: type: boolean name: type: string example: Demeter set_number: type: string example: SD01-16 sort_number: type: string example: SD01-16 banlists: type: array items: $ref: '#/components/schemas/BanlistEntry' set: $ref: '#/components/schemas/SetRef' series: description: >- Series the printing belongs to. May be `null` for printings whose underlying Card row has no series assignment. oneOf: - $ref: '#/components/schemas/SeriesRefMinimal' - type: 'null' rarity: $ref: '#/components/schemas/Rarity' variants: type: array minItems: 1 items: $ref: '#/components/schemas/PrintingVariant' description: >- Always non-empty. The first entry is synthesized from the Card row (the "main" printing); subsequent entries are rows from the `Variant` table. canvas: $ref: '#/components/schemas/Canvas' frame_material: $ref: '#/components/schemas/FrameMaterial' holo_pattern: oneOf: - $ref: '#/components/schemas/HoloPattern' - type: 'null' artist: type: string effect_current: type: string effect_printed: type: string entity: $ref: '#/components/schemas/EntityRef' images: type: array items: $ref: '#/components/schemas/PrintingImage' description: Images for the default variant. Mirrors `variants[0].images`. serialized: $ref: '#/components/schemas/PrintingSerialized' prize_card: type: boolean updated_at: type: string format: date-time Pagination: type: object required: - next_cursor - has_more properties: next_cursor: type: - string - 'null' description: Opaque cursor. Pass as `?cursor=` to fetch the next page. has_more: type: boolean Meta: type: object required: - request_id - cached - attribution_required properties: request_id: type: string example: req_0123456789abcdef cached: type: boolean attribution_required: type: boolean const: true ApiError: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - not_found - bad_request - invalid_cursor - unauthorized - forbidden - rate_limit_exceeded - quota_exceeded - internal_error - service_unavailable message: type: string request_id: type: string docs_url: type: string format: uri BanlistEntry: type: object required: - id - format_id - legality - effective_date - lift_date properties: id: type: string example: ble-1 format_id: type: - string - 'null' example: fm-1 legality: $ref: '#/components/schemas/Legality' effective_date: type: - string - 'null' format: date-time lift_date: type: - string - 'null' format: date-time SetRef: type: object required: - id - abbr - name properties: id: type: string example: st-69 abbr: type: string example: SD01 name: type: string example: Centaurbor Starter Deck SeriesRefMinimal: type: object required: - id - name properties: id: type: string example: sr-5 name: type: string example: First Edition PrintingVariant: type: object required: - name - condition - images properties: name: type: string description: >- Free-text variant name (e.g. "Normal", "Reverse Holo", "Hot Stamped"). condition: $ref: '#/components/schemas/Condition' images: type: array items: $ref: '#/components/schemas/PrintingImage' HoloPattern: type: string enum: - normal - fractal - stellar - divine - artist EntityRef: type: object required: - id - title - title_frame - class - subclasses - elements - cost - total_cost - attack - defense properties: id: type: string example: et-451 title: type: - string - 'null' title_frame: oneOf: - $ref: '#/components/schemas/TitleFrame' - type: 'null' class: $ref: '#/components/schemas/Class' subclasses: type: array items: $ref: '#/components/schemas/SubclassToken' elements: type: array items: $ref: '#/components/schemas/ElementToken' cost: type: array items: $ref: '#/components/schemas/ElementToken' total_cost: type: integer minimum: 0 attack: type: - integer - 'null' minimum: 0 defense: type: - integer - 'null' minimum: 0 PrintingImage: type: object required: - type - small - medium - large properties: type: $ref: '#/components/schemas/ImageType' small: type: string format: uri medium: type: string format: uri large: type: string format: uri PrintingSerialized: type: object required: - population properties: population: type: - integer - 'null' minimum: 0 Legality: type: string enum: - legal - semi_limited - limited - banned - illegal TitleFrame: type: string enum: - standard - standard_wide - divine - divine_wide Class: type: string enum: - spirit - elestral - rune_divine - rune_artifact - rune_stadium - rune_invoke - rune_counter SubclassToken: type: string enum: - aquatic - archaic - avian - behemoth - brute - dragon - dryad - eldritch - ethereal - golem - insectoid - oceanic - spectral - ursa ElementToken: type: string enum: - earth - fire - water - thunder - wind - frost - solar - lunar - omni ImageType: type: string enum: - card_front - art_main - art_secondary - art_cutout responses: BadRequest: description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: elestrals_live_<32char> description: > API key supplied as `Authorization: Bearer `. Keys are minted in the developer portal. Rejected in query strings. See the Authentication guide. ````