---
title: "List bases"
method: GET
path: "/api/v3/meta/workspaces/{workspaceId}/bases"
tags: ["Bases"]
---

# List bases

`GET /api/v3/meta/workspaces/{workspaceId}/bases`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}/bases`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId/bases/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of bases associated with a specific workspace.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

The request was successful, and a list of bases is returned.

- object
  - `list` Base[]: List of bases.
    - `id` string, required: Unique identifier for the base.
    - `title` string, required: Title of the base.
    - `meta` BaseMetaRes, required
      - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`)
    - `created_at` string, date-time, required: Timestamp of when the base was created.
    - `updated_at` string, date-time, required: Timestamp of when the base was last updated.
    - `workspace_id` string, required: Unique identifier for the workspace to which this base belongs to.
    - `sources` object[]: List of data sources associated with this base. This information will be included only if one or more external data sources are associated with the base.
      - `id` string, required: Unique identifier for the data source.
      - `title` string, required: Title of the data source.
      - `type` string, required: Type of the data source (e.g., pg, mysql).
      - `is_schema_readonly` boolean, required: Indicates if the schema in this data source is read-only.
      - `is_data_readonly` boolean, required: Indicates if the data (records) in this data source is read-only.
      - `integration_id` string, required: Integration ID for the data source.
  - `pageInfo` object: Always present. Offset-based, the same envelope the v3 token list uses. `totalRows` counts every base visible to the caller, not only those in this response.
    - `totalRows` integer, required: Total number of bases visible to the caller in this workspace.
    - `page` integer: Current page number, derived from `offset` and the effective page size.
    - `pageSize` integer: The page size actually applied. When no `limit` is sent this is the size of the full list; when `limit` exceeds the per-deployment cap this is the cap. Page with this value, not with the `limit` you sent, or you will skip rows.
    - `isFirstPage` boolean
    - `isLastPage` boolean

## Other responses

- `500`: The server encountered an unexpected error while processing the request.

## Changes

- **2026-10-13** `2ba4267a99d7`: 3 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the optional property `pageInfo` to the response with the `200` status

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/workspaces/:workspaceId/bases/get.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)