> ## 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. # Fetch a card by ID. > Returns a single card (entity) with inlined effects ordered by `order` ascending and the nested creature ref. Use `/v1/cards/{id}/printings` (shipping in a later release) to enumerate physical printings. ## OpenAPI ````yaml /openapi.yaml get /v1/cards/{id} 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/cards/{id}: get: tags: - Cards summary: Fetch a card by ID. description: | Returns a single card (entity) with inlined effects ordered by `order` ascending and the nested creature ref. Use `/v1/cards/{id}/printings` (shipping in a later release) to enumerate physical printings. operationId: getCard parameters: - $ref: '#/components/parameters/CardIdPath' responses: '200': description: The requested card. content: application/json: schema: $ref: '#/components/schemas/CardResponse' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: parameters: CardIdPath: name: id in: path required: true schema: type: string description: Card (entity) ID (`et-...`). schemas: CardResponse: type: object required: - data - meta properties: data: $ref: '#/components/schemas/Card' meta: $ref: '#/components/schemas/Meta' Card: type: object required: - id - name - title - identity - class - subclasses - elements - cost - total_cost - attack - defense - traits - banlists - effects - rulings - creature - base_printing_id - updated_at properties: id: type: string example: et-100 name: type: string example: Waspivy title: type: - string - 'null' identity: type: array items: type: string description: >- Array of identity strings for the Entity. Today every row carries a single identity; the array shape future-proofs a later release where an Entity may carry multiple identities. 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 traits: type: - string - 'null' banlists: type: array items: $ref: '#/components/schemas/BanlistEntry' effects: type: array items: $ref: '#/components/schemas/InlineEffect' rulings: type: array items: $ref: '#/components/schemas/Ruling' creature: oneOf: - $ref: '#/components/schemas/CreatureRef' - type: 'null' description: >- The Elestral creature this entity belongs to. Null for non-Elestral classes (Spirit, Rune, Stadium, Artifact, etc.) which don't have a creature lineage. base_printing_id: type: string example: cd-1813 updated_at: type: string format: date-time 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 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 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 InlineEffect: type: object required: - type - categories - condition - cost - text - order properties: type: $ref: '#/components/schemas/EffectType' categories: type: array items: $ref: '#/components/schemas/EffectCategory' condition: type: - string - 'null' cost: type: - string - 'null' text: type: string order: type: integer minimum: 0 Ruling: type: object required: - id - date - text properties: id: type: string example: rul-1 date: type: string format: date example: '2014-09-20' text: type: string CreatureRef: type: object required: - id - name - class - elements properties: id: type: string example: el-159 name: type: string example: Waspivy class: $ref: '#/components/schemas/Class' elements: type: array items: $ref: '#/components/schemas/ElementToken' Legality: type: string enum: - legal - semi_limited - limited - banned - illegal EffectType: type: string enum: - active - conditional - instant - passive EffectCategory: type: string enum: - search - special_ascend - special_cast - normal_cast - nexus - daze - enrage - suppress - foretell - card_removal - elestral_removal - rune_removal - force_disenchant - burn - heal - draw - enchant - stat_modification - direct_attack - piercing_damage - hand_ripper - mill - unaffected - protection - steal - change_properties - negate - recycle - block - position - prevention - playing_condition - upkeep - replacement_effect - sever - win_condition responses: NotFound: description: Resource not found. 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. ````