---
title: "Download a card image"
method: GET
path: "/v1/cards/{id}/image"
tags: ["Images"]
---

# Download a card image

`GET /v1/cards/{id}/image`

## Request

- Base URL: `https://tcgdata-api.ottenniels1999.workers.dev`
- URL: `https://tcgdata-api.ottenniels1999.workers.dev/v1/cards/{id}/image`
- Auth: HTTP bearer

Fetch the verified card artwork from your server with the same Bearer key. Follow images.small or images.large relative to the API origin. Returns binary WebP, capped at 1 MiB. This consumes one request from the shared daily and monthly allowances, including an admitted error. The image counter is diagnostic, not a separate commercial allowance. Do not embed a key in a URL or expose it in browser code.

1 admitted HTTP request. Unknown query/body parameters are rejected. Examples contain illustrative data and placeholder IDs; they are not live catalogue records.

## Path parameters

- `id` string, required

## Query parameters

- `size` 'small' | 'large'
- `catalogue_card_id` string
- `face` integer

## Response `200`

Success. 1 admitted HTTP request.

## Other responses

- `400`: Invalid request or batch_size_exceeded (more IDs than the account plan allows)
- `401`: Invalid or missing key
- `403`: Inactive account, expired free test or resource_limits_unconfigured
- `404`: Not found or unavailable
- `405`: Wrong method
- `409`: Ambiguous printing or variant
- `413`: Oversized request body or response_too_large (response exceeds 1 MiB)
- `415`: Wrong content type
- `429`: Monthly, UTC-daily or minute request limit; authenticated account limits include a paid-plan or custom-access upgrade suggestion. Defensive resource-limit errors retain the ordinary error envelope.
- `503`: Disabled, unconfigured or temporarily unavailable

---

[API](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history.md) · [All operations](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history/llms.txt) · [OpenAPI document](https://skmtc.dev/tcgdata/apis/tcgdata-dev-multi-game-prices-and-daily-history/revisions/1db91fd8a408?raw)