---
title: "Get DataTables"
method: GET
path: "/dataTables"
tags: ["DataTable"]
---

# Get DataTables

`GET /dataTables`

Query for DataTables in a workspace

## Query parameters

- `workspace_id` string, required
- `limit` integer
- `cursor` string

## Response `200`

Results of the query

- DataTableQueryResult — Results wrapper for DataTable queries
  - `dataTables` DataTable[] — All DataTables matching the query
    - `id` string
    - `workspace_id` string — The ID of the workspace associated with this DataTable
    - `name` string — The display name for the DataTable
    - `description` string, nullable — The Description for the DataTable
    - `scenario_ids` string[] — The row (scenario) IDs contained in DataTable
    - `created_time` integer — Time at which the entity was created
    - `created_by_id` string — The ID of the user who created this entity
    - `last_updated_time` integer — Time at which the entity was last updated
    - `last_updated_by_id` string — The ID of the user who last updated this entity
    - `resource_groups` DerivedResourceGroup[] — Resource groups this resource belongs to
      - `resource_group_id` string — ID of the resource group
      - `short_name` string — Name of the resource group
      - `parent_id` string — ID of the parent to which this ResourceGroup belongs
      - `parent_namespace` 'workspaces' — Namespace of the parent to which this ResourceGroup belongs
    - `used_by_test_count` integer — Count of tests using this DataTable. Populated in query responses.
  - `cursor` string — Cursor used for pagination

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)