---
title: "GET /shares/{share}/schemas/{schema}/tables/{name}/metadata"
method: GET
path: "/shares/{share}/schemas/{schema}/tables/{name}/metadata"
tags: ["DeltaSharingService"]
---

# GET /shares/{share}/schemas/{schema}/tables/{name}/metadata

`GET /shares/{share}/schemas/{schema}/tables/{name}/metadata`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/delta-incubator/apis/delta-sharing-api/docs/shares/:share/schemas/:schema/tables/:name/metadata/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `share` string, required
- `schema` string, required
- `name` string, required

## Response `200`

OK

- QueryResponse: Response for a query against a table.
  - `parquet` ParquetResponse: Response for a query against a table in Parquet format.
    - `entries` ParquetLogMessage[]
      - `protocol` ProtocolParquet: Protocol for Parquet response.
        - `minReaderVersion` integer: The minimum version of the protocol that a client must implement in order to correctly read a Delta Lake table.
      - `metadata` MetadataParquet: Metadata for Parquet response.
        - `id` string: Unique identifier for this table
        - `name` string: User-provided identifier for this table
        - `description` string: User-provided description for this table
        - `format` Format: File format for data files in a table
          - `provider` string: Name of the encoding for files in this table
          - `options` object: A map containing configuration options for the format
        - `schemaString` string: Schema of the table
        - `partitionColumns` string[]: An array containing the names of columns by which the data should be partitioned
  - `delta` DeltaResponse: Response for a query against a table in Delta format.
    - `entries` DeltaLogMessage[]
      - `protocol` ProtocolDelta: Protocol for Delta response.
        - `minReaderVersion` integer: The minimum version of the protocol that a client must implement in order to correctly read a Delta Lake table.
        - `minWriterVersion` integer
      - `metadata` MetadatDelta: Metadata for Delta response.
        - `deltaMetadata` Metadata: Metadata for a table
          - `id` string: Unique identifier for this table Validate GUID
          - `name` string: User-provided identifier for this table
          - `description` string: User-provided description for this table
          - `format` Format: File format for data files in a table
            - `provider` string: Name of the encoding for files in this table
            - `options` object: A map containing configuration options for the format
          - `schemaString` string: Schema of the table
          - `partitionColumns` string[]: An array containing the names of columns by which the data should be partitioned
          - `createdTime` string: The time when this metadata action is created, in milliseconds since the Unix epoch
          - `options` object: A map containing configuration options for the metadata action
        - `version` string: The table version the metadata corresponds to, returned when querying table data with a version or timestamp parameter, or cdf query with includeHistoricalMetadata set to true.
        - `size` string: The size of the table in bytes, will be returned if available in the delta log.
        - `numFiles` string: The number of files in the table, will be returned if available in the delta log.

## Other responses

- `default`: Default error response

## Changes

- **2025-02-27** `60220bae69ec`: 2 info
  - api tag `official` removed
  - api tag `tables` removed
- **2025-02-16** `af378e92b27b`: 2 info
  - api tag `official` added
  - api tag `tables` added

[Operation history](https://skmtc.dev/delta-incubator/apis/delta-sharing-api/changes/shares/:share/schemas/:schema/tables/:name/metadata/get.md)

---

[API](https://skmtc.dev/delta-incubator/apis/delta-sharing-api.md) - [All operations](https://skmtc.dev/delta-incubator/apis/delta-sharing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/delta-incubator/apis/delta-sharing-api/revisions/a47a0389fffc?raw)