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

# get

Fetch the details of a table.

# 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/{tableId}": {
      "get": {
        "summary": "get",
        "description": "Fetch the details of a table.",
        "operationId": "Tables_GetTable",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tamr.api.tables.v1beta1.GetTableResponse"
                }
              }
            }
          }
        },
        "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": "tableId",
            "description": "The identifier of the table to fetch. Can either be the table stripe id or the table name.",
            "in": "path",
            "required": true,
            "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.GetTableResponse": {
        "type": "object",
        "properties": {
          "table": {
            "description": "Table",
            "title": "Table",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.tables.v1beta1.Table"
              }
            ]
          }
        }
      },
      "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."
          }
        }
      }
    }
  }
}
```