---
title: "GET /api/public/tiles/card/{uuid}/{zoom}/{x}/{y}"
method: GET
path: "/api/public/tiles/card/{uuid}/{zoom}/{x}/{y}"
tags: ["/api/public"]
---

# GET /api/public/tiles/card/{uuid}/{zoom}/{x}/{y}

`GET /api/public/tiles/card/{uuid}/{zoom}/{x}/{y}`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/public/tiles/card/{uuid}/{zoom}/{x}/{y}`
- Auth: API key in header `X-API-Key`

Generates a single tile image for a publicly-accessible Card using the map visualization. Does not require auth
  credentials. Public sharing must be enabled.

## Path parameters

- `uuid` string, required
- `zoom` integer, required
- `x` integer, required
- `y` integer, required

## Query parameters

- `parameters` MetabaseParametersSchemaParameterWithValue[]
  - `default` union
    - union: A single scalar parameter value.
      - string
      - number
      - boolean
    - MetabaseLibSchemaParameterParameterValueScalar[]
      - union: A single scalar parameter value.
        - string
        - number
        - boolean
  - `id` string, required: Schema for a string that cannot be blank.
  - `name` string: Schema for a string that cannot be blank.
  - `options` MetabaseLibSchemaParameterParameterOptions: Options the frontend attaches to a parameter value.
    - `case-sensitive` boolean
    - `include-current` boolean
  - `sectionId` string: Schema for a string that cannot be blank.
  - `slug` string: Schema for a string that cannot be blank.
  - `target` union
    - unknown[]
      - unknown
    - unknown[]
      - unknown
    - unknown[]: A :text-tag parameter :target applies to parameterized text cards in viz settings
      - unknown
    - unknown[]: schema for a valid MBQL 4 :field clause
      - unknown
  - `type` 'number' | 'text' | 'date' | 'boolean' | 'date/single' | 'id' | 'category' | 'location/city' | 'location/state' | 'location/zip_code' | 'location/country' | 'date/range' | 'date/month-year' | 'date/quarter-year' | 'date/relative' | 'date/all-options' | 'temporal-unit' | 'number/!=' | 'number/<=' | 'number/=' | 'number/>=' | 'number/between' | 'string/!=' | 'string/=' | 'string/contains' | 'string/does-not-contain' | 'string/ends-with' | 'string/starts-with' | 'boolean/=': Valid parameter :type
  - `value` union
    - union: A single scalar parameter value.
      - string
      - number
      - boolean
    - MetabaseLibSchemaParameterParameterValueScalar[]
      - union: A single scalar parameter value.
        - string
        - number
        - boolean
- `latField` unknown[], required: schema for a valid MBQL 4 :field clause
  - unknown
- `lonField` unknown[], required: schema for a valid MBQL 4 :field clause
  - unknown

## Response `2XX`

Successful response

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 3 info
  - for the `query` request parameter `latField`, the type was generalized from `string` to no type
  - for the `query` request parameter `lonField`, the type was generalized from `string` to no type
  - for the `query` request parameter `parameters`, the type was generalized from `string` to no type
- **2026-03-09** `78297d193ca4`: 1 info
  - api operation id `get-api-public-tiles-card-uuid-zoom-x-y` was added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/public/tiles/card/:uuid/:zoom/:x/:y/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)