---
title: "Get Card Route"
method: GET
path: "/api/search/{team_key}/cards/{slug}"
tags: ["search"]
---

# Get Card Route

`GET /api/search/{team_key}/cards/{slug}`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/search/{team_key}/cards/{slug}`
- Auth: HTTP bearer

Card definition plus latest successful snapshot (embed contract).

## Path parameters

- `slug` string, required
- `team_key` string, required

## Response `200`

Successful Response

- CardDetail
  - `key` string, required
  - `slug` string, required
  - `title` string, required
  - `description` string, nullable, required
  - `kind` 'table' | 'bar' | 'summary' | 'actions' | 'opportunities', required
  - `prompt` string, required
  - `sql` string, nullable, required
  - `spec` CardChartSpec, required: Pinned render contract: refresh rows must contain every column key.
    - `type` 'table' | 'bar' | 'summary' | 'actions' | 'opportunities', required
    - `columns` CardColumn[], required
      - `key` string, required
      - `label` string, required
      - `format` string, nullable
    - `xKey` string, nullable
    - `series` CardColumn[], nullable
      - `key` string, required
      - `label` string, required
      - `format` string, nullable
  - `refreshIntervalHours` integer, nullable, required
  - `nextRefreshAt` string, date-time, nullable, required
  - `lastRefreshedAt` string, date-time, nullable, required
  - `latestStatus` 'completed' | 'failed', required
  - `snapshot` CardSnapshotDetail, required
    - `key` string, required
    - `status` 'completed' | 'failed', required
    - `payload` union, required
      - object
      - object[]
    - `sqlUsed` string, nullable, required
    - `error` string, nullable, required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)