TableMetadata

TableMetadata schema from Apache Iceberg REST Catalog API

ACIDAnalyticsApacheData LakeLakehouseOpen-SourceTable Format

Properties

Name	Type	Description
format-version	integer
table-uuid	string
location	string
last-updated-ms	integer
next-row-id	integer	A long higher than all assigned row IDs; the next snapshot's first-row-id.
properties	object
schemas	array
current-schema-id	integer
last-column-id	integer
partition-specs	array
default-spec-id	integer
last-partition-id	integer
sort-orders	array
default-sort-order-id	integer
encryption-keys	array
snapshots	array
refs	object
current-snapshot-id	integer
last-sequence-number	integer
snapshot-log	object
metadata-log	object
statistics	array
partition-statistics	array

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/apache-iceberg/refs/heads/main/json-schema/rest-catalog-open-api-table-metadata-schema.json",
  "title": "TableMetadata",
  "description": "TableMetadata schema from Apache Iceberg REST Catalog API",
  "type": "object",
  "properties": {
    "format-version": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3
    },
    "table-uuid": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "last-updated-ms": {
      "type": "integer",
      "format": "int64"
    },
    "next-row-id": {
      "type": "integer",
      "format": "int64",
      "description": "A long higher than all assigned row IDs; the next snapshot's first-row-id."
    },
    "properties": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "schemas": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Schema"
      }
    },
    "current-schema-id": {
      "type": "integer"
    },
    "last-column-id": {
      "type": "integer"
    },
    "partition-specs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PartitionSpec"
      }
    },
    "default-spec-id": {
      "type": "integer"
    },
    "last-partition-id": {
      "type": "integer"
    },
    "sort-orders": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SortOrder"
      }
    },
    "default-sort-order-id": {
      "type": "integer"
    },
    "encryption-keys": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/EncryptedKey"
      }
    },
    "snapshots": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Snapshot"
      }
    },
    "refs": {
      "$ref": "#/components/schemas/SnapshotReferences"
    },
    "current-snapshot-id": {
      "type": "integer",
      "format": "int64"
    },
    "last-sequence-number": {
      "type": "integer",
      "format": "int64"
    },
    "snapshot-log": {
      "$ref": "#/components/schemas/SnapshotLog"
    },
    "metadata-log": {
      "$ref": "#/components/schemas/MetadataLog"
    },
    "statistics": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StatisticsFile"
      }
    },
    "partition-statistics": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PartitionStatisticsFile"
      }
    }
  },
  "required": [
    "format-version",
    "table-uuid"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/rest-catalog-open-api-table-metadata"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.