GET /accounts/{account_id}/r2-catalog/{bucket_name}/namespaces/{namespace}/tables/{table_name}

Returns full Apache Iceberg metadata for a single table: schema, partition specs, sort orders, properties, and recent snapshot history. Designed for catalog introspection UIs that need per-table details without holding R2 credentials.

The metadata.snapshots, metadata.snapshot-log, and metadata.metadata-log arrays are pruned to the most recent 10 entries by timestamp-ms. Use total_snapshots and returned_snapshots to surface the truncation to end users.

Servers

Path parameters

Name Type Required Description
table_name String Yes

The table name within the given namespace.

bucket_name String Yes

Specifies the R2 bucket name.

namespace String Yes

The namespace identifier. For nested namespaces, use %1F as separator (e.g., "bronze%1Fanalytics").

account_id String Yes

Identifies the account.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.