> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e6data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inspect table

> inspect table. GET /api/v1/catalogs/{catalog_id}/tables/{name}/inspection. Inspect Iceberg snapshots, history, files or summary at an optional pinned snapshot. Pass namespace as an

ReferenceApplies to: Unified engine deployments

## Related guidance

[Addresses and access](https://docs.e6data.com/transformation/http/access.md) · [Request identity](https://docs.e6data.com/transformation/http/request-identity.md) · [Errors and recovery](https://docs.e6data.com/transformation/http/errors.md) · [Pagination and results](https://docs.e6data.com/transformation/http/results.md)


## OpenAPI

````yaml openapi/transformation.json GET /api/v1/catalogs/{catalog_id}/tables/{name}/inspection
openapi: 3.1.0
info:
  description: >-
    HTTP contracts for the Unified engine. Requests use the connected
    deployment's access model and configured owner. Response examples are
    illustrative; inspect your engine response in your client. SQL-managed
    secrets, credentials, streaming pipelines and maintenance run through
    session operations.
  title: Laminar Unified HTTP API
  version: v1
servers:
  - url: https://engine.example.com
    description: >-
      Example engine origin. Replace it with your deployment URL and any API
      mount prefix.
security: []
paths:
  /api/v1/catalogs/{catalog_id}/tables/{name}/inspection:
    get:
      tags:
        - Catalogs and tables
      summary: inspect table
      description: >-
        inspect table. GET
        /api/v1/catalogs/{catalog_id}/tables/{name}/inspection. Inspect Iceberg
        snapshots, history, files or summary at an optional pinned snapshot.
        Pass namespace as an array of components.
      operationId: inspect_table
      parameters:
        - in: path
          name: catalog_id
          required: true
          schema:
            format: uuid
            type: string
        - in: path
          name: name
          required: true
          schema:
            type: string
        - in: query
          name: continuation_token
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            description: >-
              Page size, bounded by the server. For query results this counts
              Arrow batches, default 1.
            minimum: 1
            type: integer
        - in: query
          name: namespace
          required: true
          schema:
            items:
              type: string
            type: array
        - in: query
          name: section
          required: false
          schema:
            enum:
              - snapshots
              - history
              - files
              - summary
        - in: query
          name: snapshot_id
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/data_connectors_core_src_models_inspection_rs_TableInspectionResponse
          description: Successful response.
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: Check the request fields
              schema:
                $ref: '#/components/schemas/ApiError'
          description: A rejected or failed request. Inspect error.code before retrying.
components:
  schemas:
    data_connectors_core_src_models_inspection_rs_TableInspectionResponse:
      properties:
        current_snapshot_id:
          anyOf:
            - type: string
            - type: 'null'
        files:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_Page_TableFile'
            - type: 'null'
        history:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_lib_rs_Page_TableSnapshotHistory
            - type: 'null'
        metadata_revision:
          type: string
        selected_snapshot_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Decimal strings preserve 64-bit snapshot IDs in browser clients.
        snapshots:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_Page_TableSnapshot'
            - type: 'null'
        statistics:
          anyOf:
            - $ref: >-
                #/components/schemas/data_connectors_core_src_models_inspection_rs_TableFileStatistics
            - type: 'null'
        table_identity:
          type: string
      required:
        - table_identity
        - metadata_revision
        - selected_snapshot_id
        - current_snapshot_id
      type: object
    ApiError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    shared_common_src_lib_rs_Page_TableFile:
      properties:
        continuation_token:
          anyOf:
            - type: string
            - type: 'null'
        items:
          items:
            $ref: >-
              #/components/schemas/data_connectors_core_src_models_inspection_rs_TableFile
          type: array
      required:
        - items
        - continuation_token
      type: object
    shared_common_src_lib_rs_Page_TableSnapshotHistory:
      properties:
        continuation_token:
          anyOf:
            - type: string
            - type: 'null'
        items:
          items:
            $ref: >-
              #/components/schemas/data_connectors_core_src_models_inspection_rs_TableSnapshotHistory
          type: array
      required:
        - items
        - continuation_token
      type: object
    shared_common_src_lib_rs_Page_TableSnapshot:
      properties:
        continuation_token:
          anyOf:
            - type: string
            - type: 'null'
        items:
          items:
            $ref: >-
              #/components/schemas/data_connectors_core_src_models_inspection_rs_TableSnapshot
          type: array
      required:
        - items
        - continuation_token
      type: object
    data_connectors_core_src_models_inspection_rs_TableFileStatistics:
      properties:
        data_file_count:
          type: string
        data_size_bytes:
          type: string
        delete_entry_count:
          type: string
        delete_file_count:
          type: string
        delete_records:
          description: >-
            Delete records may overlap; subtracting this from data records is
            incorrect.
          type: string
        delete_size_bytes:
          type: string
        records_before_deletes:
          type: string
        total_size_bytes:
          type: string
        visible_record_count:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Present only when no row-delete files exist. Otherwise execute
            COUNT(*) for an exact count.
      required:
        - data_file_count
        - delete_file_count
        - delete_entry_count
        - data_size_bytes
        - delete_size_bytes
        - total_size_bytes
        - records_before_deletes
        - delete_records
        - visible_record_count
      type: object
    data_connectors_core_src_models_inspection_rs_TableFile:
      properties:
        added_snapshot_id:
          anyOf:
            - type: string
            - type: 'null'
        content:
          $ref: >-
            #/components/schemas/data_connectors_core_src_models_inspection_rs_TableFileContent
        content_offset:
          anyOf:
            - type: string
            - type: 'null'
          description: Distinguishes multiple deletion vectors stored in one physical file.
        content_size_bytes:
          anyOf:
            - type: string
            - type: 'null'
        data_sequence_number:
          anyOf:
            - type: string
            - type: 'null'
        equality_field_ids:
          items:
            type: integer
          type: array
        file_sequence_number:
          anyOf:
            - type: string
            - type: 'null'
        file_size_bytes:
          type: string
        format:
          type: string
        partition:
          items:
            $ref: >-
              #/components/schemas/data_connectors_core_src_models_inspection_rs_TableFilePartition
          type: array
        partition_spec_id:
          type: integer
        path:
          type: string
        record_count:
          type: string
        referenced_data_file:
          anyOf:
            - type: string
            - type: 'null'
        sort_order_id:
          anyOf:
            - type: integer
            - type: 'null'
      required:
        - path
        - content
        - format
        - file_size_bytes
        - record_count
        - partition_spec_id
        - partition
        - added_snapshot_id
        - data_sequence_number
        - file_sequence_number
        - equality_field_ids
        - sort_order_id
        - referenced_data_file
        - content_offset
        - content_size_bytes
      type: object
    data_connectors_core_src_models_inspection_rs_TableSnapshotHistory:
      properties:
        is_current_ancestor:
          type: boolean
        made_current_at_ms:
          type: integer
        snapshot_available:
          type: boolean
        snapshot_id:
          type: string
      required:
        - snapshot_id
        - made_current_at_ms
        - snapshot_available
        - is_current_ancestor
      type: object
    data_connectors_core_src_models_inspection_rs_TableSnapshot:
      properties:
        is_current:
          type: boolean
        is_selected:
          type: boolean
        manifest_list:
          type: string
        operation:
          type: string
        parent_snapshot_id:
          anyOf:
            - type: string
            - type: 'null'
        schema_id:
          anyOf:
            - type: integer
            - type: 'null'
        sequence_number:
          type: string
        snapshot_id:
          type: string
        summary:
          additionalProperties:
            type: string
          type: object
        timestamp_ms:
          type: integer
      required:
        - snapshot_id
        - parent_snapshot_id
        - sequence_number
        - timestamp_ms
        - operation
        - schema_id
        - manifest_list
        - summary
        - is_current
        - is_selected
      type: object
    data_connectors_core_src_models_inspection_rs_TableFileContent:
      oneOf:
        - const: data
          type: string
        - const: position_deletes
          type: string
        - const: equality_deletes
          type: string
    data_connectors_core_src_models_inspection_rs_TableFilePartition:
      properties:
        data_type:
          type: string
        name:
          type: string
        value:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - name
        - data_type
        - value
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.