> ## Documentation Index > Fetch the complete documentation index at: https://docs.cromos.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get a series > One series and every expansion inside it. You get [the series object](/series/object) with its expansions inline, ordered by release date. That is one request to render a whole browse column. Ids are short: `base`, `swsh`, `sv`. Use [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. operationId: getSeries parameters: - schema: type: string required: true name: id in: path responses: '200': description: Series detail headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string 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/expansions/base1/logo/low.webp high: https://assets.cromos.so/expansions/base1/logo/high.webp palette: - '#fac32c' - '#2a2e54' - '#6d2239' - '#3c5da4' expansions: - id: base1 name: Base Set logo: low: >- https://assets.cromos.so/expansions/base1/logo/low.webp high: >- https://assets.cromos.so/expansions/base1/logo/high.webp symbol: null palette: - '#fac32c' - '#2a2e54' - '#6d2239' - '#3c5da4' 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 palette: - '#010202' - '#43ac4b' - '#93c562' - '#434443' 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 palette: - '#000000' - '#fefefe' - '#2c2c2c' - '#636363' release_date: '1999-07-01' card_count_total: 53 - id: wp name: W Promotional logo: null symbol: null palette: 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 palette: - '#130c14' - '#dbcbb3' - '#543e2b' - '#bba37c' 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 palette: - '#0b0c0b' - '#fc150b' - '#344d62' - '#f3fafd' 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 palette: - '#ec193e' - '#241e23' - '#396170' - '#9aacbf' release_date: '2000-04-24' card_count_total: 83 error: null '304': description: >- Not modified. The `If-None-Match` you sent still matches, and there is no body. headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string '400': description: Bad request headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limited headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string Retry-After: description: Seconds to wait before retrying. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal error headers: ETag: description: >- A strong validator over the response body. Send it back as `If-None-Match` to get a `304 Not Modified` when nothing has changed. schema: type: string RateLimit: description: >- Remaining budget in the current window, RFC 9239 draft-7 form: `limit=300, remaining=284, reset=41`. `reset` is seconds until the window rolls. schema: type: string RateLimit-Policy: description: >- The policy the budget above is drawn from. `300;w=60` is 300 requests a minute. schema: type: string 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' palette: type: array nullable: true items: type: string description: >- Up to four dominant colours from the logo, most prominent first, as `#rrggbb`. Null when no logo is available or it yields no colour. May contain fewer than four: a two-tone logo has two, and the list is never padded with colours the image does not contain. required: - id - name - logo - palette 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. palette: type: array nullable: true items: type: string description: >- Up to four dominant colours from the logo, most prominent first, as `#rrggbb`. Null when no logo is available or it yields no colour. May contain fewer than four: a two-tone logo has two, and the list is never padded with colours the image does not contain. 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 - palette - 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 ````