---
title: "List Schemas"
method: GET
path: "/v1/datalake/schemas"
tags: ["Schemas"]
---

# List Schemas

`GET /v1/datalake/schemas`

Retrieves schema information for all IDS (Intermediate Data Schema) in the organization.

**Performance Notice**: This endpoint may timeout with large datasets (500+ schemas). For better performance, use the targeted alternatives below.

**Recommended Alternatives**:
1. **List available IDS (if needed)**: `GET /v1/artifacts/ids`
2. **Get specific components**:
- Schema: `GET /v1/artifacts/ids/{namespace}/{slug}/{version}/files/schema`
- Mapping: `GET /v1/artifacts/ids/{namespace}/{slug}/{version}/files/mapping`
- Expected: `GET /v1/artifacts/ids/{namespace}/{slug}/{version}/files/expected`
- README: `GET /v1/artifacts/ids/{namespace}/{slug}/{version}/files/readme`

**When to use alternatives**: If you need specific schema details or are working with organizations that have many IDS definitions.

## Query parameters

- `type` string
- `version` string
- `fields` string

## Headers

- `ts-auth-token` string, required
- `x-org-slug` string, required

## Response `200`

200

- object[]
  - `namespace` string
  - `slug` string
  - `version` string
  - `schema` object
    - `type` string
    - `properties` object
      - `assay_name` object
        - `type` string
      - `temperature` object
        - `type` string
      - `timestamp` object
        - `type` string
        - `format` string
      - `readout` object
        - `type` string
        - `items` object
          - `type` string
  - `expected` object
  - `elasticsearch` object
  - `athena` object
  - `readme` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)
