---
title: "List the driver data-type catalog"
method: GET
path: "/data-types"
tags: ["Data types"]
---

# List the driver data-type catalog

`GET /data-types`

## Request

- Base URL: `https://api.drawsql.app/v1`
- URL: `https://api.drawsql.app/v1/data-types`
- Auth: HTTP bearer

The catalog of column data types, grouped per driver. Use it to resolve
the `driver_data_type_name` on schema columns (the schema formats identify
types by name, not by internal id). The catalog is global and static per
driver — it changes only when DrawSQL ships new types.

Supports ETag conditional requests (the ETag hashes the catalog, so it is
stable between deploys). Rate limit: 60 requests/minute per token.

## Query parameters

- `driver` 'mysql' | 'pgsql' | 'sqlsrv'

## Headers

- `If-None-Match` string

## Response `200`

The data-type catalog, grouped per driver.

- object
  - `data` object, required: Data types keyed by driver.

## Other responses

- `304`: The catalog is unchanged since the supplied `If-None-Match`.
- `401`: Missing, malformed, expired, or revoked token (code `unauthenticated`), or a valid token whose team no longer exists or whose user is no longer a member of that team (code `invalid_token`).
- `403`: The token's team is not on a paid plan (code `plan_required`), or the token is not allowed to perform this action (code `forbidden`).
- `422`: A query parameter failed validation.
- `429`: Too many requests.

---

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