---
updatedAt: 2026-08-25T14:01:30.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# list

Fetch a page of tables.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Tables",
    "version": "v1beta1"
  },
  "tags": [
    {
      "name": "tamr.api.tables.v1beta1.Tables"
    }
  ],
  "paths": {
    "/api/v1beta1/projects/{projectId}/tables": {
      "get": {
        "summary": "list",
        "description": "Fetch a page of tables.",
        "operationId": "Tables_ListTables",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tamr.api.tables.v1beta1.ListTablesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "projectId",
            "description": "Required. Unique project stripe ID or name of the table's parent project.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "description": "Optional. The maximum number of tables to return. Default is 10, and the maximum allowed is 100.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageToken",
            "description": "Optional. The next_page_token value returned from a previous response. Set this value to continue paging.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dataProductId",
            "description": "Optional. The data product ID to filter by.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "tamr.api.tables.v1beta1.Tables"
        ]
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-API-KEY",
        "value": "example-api-key"
      }
    ]
  },
  "servers": [
    {
      "url": "https://api-examples.tamr.cloud"
    }
  ],
  "components": {
    "schemas": {
      "tamr.api.tables.v1beta1.ListTablesResponse": {
        "type": "object",
        "properties": {
          "tables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/tamr.api.tables.v1beta1.Table"
            },
            "description": "A page of results. Tables are ordered by create time, oldest first.",
            "readOnly": true
          },
          "nextPageToken": {
            "type": "string",
            "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.",
            "readOnly": true
          }
        }
      },
      "tamr.api.tables.v1beta1.Table": {
        "type": "object",
        "properties": {
          "tableId": {
            "type": "string",
            "description": "Output only. Unique stripe ID of the table, generated by the service on creation.",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "description": "Unique, immutable name of the table used in the URL. Table names are unique per project.\nThe name can only contain lowercase letters, numbers, and hyphens. Spaces, special characters and\nuppercase letters are not permitted."
          },
          "displayName": {
            "type": "string",
            "description": "User-friendly display name of the table."
          },
          "description": {
            "type": "string",
            "description": "Optional. Description of the table."
          },
          "projectId": {
            "type": "string",
            "description": "Output only. Unique stripe ID of the table's parent project.",
            "readOnly": true
          },
          "dataProductId": {
            "type": "string",
            "description": "Output only. Unique stripe ID of the table's parent data product.",
            "readOnly": true
          },
          "createdBy": {
            "description": "Output only. The user who created the table.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.User"
              }
            ]
          },
          "updatedBy": {
            "description": "Output only. The user who last updated the table.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.User"
              }
            ]
          },
          "createTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. Time when the table was created.",
            "readOnly": true
          },
          "updateTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. Time when the table was last updated.",
            "readOnly": true
          }
        },
        "description": "Tables are the system of record (SOR) for a data product's golden records.",
        "required": [
          "name",
          "displayName"
        ]
      },
      "tamr.api.v1beta1.User": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The unique identifier of the user."
          },
          "email": {
            "type": "string",
            "description": "The email address of the user."
          }
        }
      }
    }
  }
}
```