---
title: "POST /api/dashboard/{dashboard-id}/dashcard/{dashcard-id}/card/{card-id}/query"
method: POST
path: "/api/dashboard/{dashboard-id}/dashcard/{dashcard-id}/card/{card-id}/query"
tags: ["/api/dashboard"]
---

# POST /api/dashboard/{dashboard-id}/dashcard/{dashcard-id}/card/{card-id}/query

`POST /api/dashboard/{dashboard-id}/dashcard/{dashcard-id}/card/{card-id}/query`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/dashboard/{dashboard-id}/dashcard/{dashcard-id}/card/{card-id}/query`
- Auth: API key in header `X-API-Key`

Run the query associated with a Saved Question (`Card`) in the context of a `Dashboard` that includes it.

## Path parameters

- `dashboard-id` integer, required
- `dashcard-id` integer, required
- `card-id` integer, required

## Request body

- object
  - `dashboard_load_id` string, nullable: value must be a non-blank string.
  - `parameters` MetabaseParametersSchemaParameterWithValue[], nullable
    - `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

## Response `2XX`

Successful response

## Other responses

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

## Changes

- **2026-11-04** `2e178f5a7934`: 2 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `dashboard_load_id` request property `oneOf` list
  - removed `subschema #1, subschema #2` from the `parameters` request property `oneOf` list
  - added `subschema #1, subschema #2` to the `dashboard_load_id` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `parameters` request property `anyOf` list
- **2026-03-09** `78297d193ca4`: 1 info
  - api operation id `post-api-dashboard-dashboard-id-dashcard-dashcard-id-card-card-id-query` was added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/dashboard/:dashboard-id/dashcard/:dashcard-id/card/:card-id/query/post.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)