---
title: "Get query schema"
method: GET
path: "/api/v1/query/schema"
tags: ["query"]
---

# Get query schema

`GET /api/v1/query/schema`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/query/schema`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/query/schema/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the schema for TRQL queries, including all available tables, their columns, data types, descriptions, and allowed values.

## Response `200`

Schema retrieved successfully

- object
  - `tables` object[]
    - `name` string: Table name used in TRQL queries
    - `description` string: Description of the table
    - `timeColumn` string: The primary time column for this table
    - `columns` object[]
      - `name` string: Column name
      - `type` string: ClickHouse data type
      - `description` string: Column description
      - `example` string: Example value
      - `allowedValues` string[]: Allowed values for enum-like columns
      - `coreColumn` boolean: Whether this is a core column included in default queries

## Other responses

- `401`: Unauthorized - API key is missing or invalid

## Changes

- **2026-04-13** `2af886115b5b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/query/schema/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)