---
title: "List SQL Queries"
method: GET
path: "/sql"
tags: ["SQL Queries"]
---

# List SQL Queries

`GET /sql`

## Request

- Base URL: `https://api.us-e1.tago.io`
- URL: `https://api.us-e1.tago.io/sql`
- Auth: API key in header `Profile-Token`
- TypeScript: <https://skmtc.dev/tago/apis/tagoio-api/docs/sql/get.ts> (a function with typed inputs; its response is checked against the schema)

List your saved queries. Returns `{ status, result: [...] }` following the house list-endpoint standard; there is no `total` key. Page by requesting successive `page` values until a short page is returned.

## Query parameters

- `fields` string
- `filter[name]` string
- `filter[active]` boolean
- `filter[tags][0][key]` string
- `filter[tags][0][value]` string
- `orderBy` string
- `amount` integer
- `page` integer

## Response `200`

List of your saved queries (projected to the requested fields).

- object
  - `status` boolean
  - `result` object[]
    - `id` string
    - `name` string
    - `tags` object[]
      - `key` string
      - `value` string
    - `active` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Unknown field in `fields[]`.

## Changes

- **2026-11-07** `1a281f04cdab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tago/apis/tagoio-api/changes/sql/get.md)

---

[API](https://skmtc.dev/tago/apis/tagoio-api.md) - [All operations](https://skmtc.dev/tago/apis/tagoio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tago/apis/tagoio-api/revisions/1a281f04cdab?raw)