Load table

FREE

Load a registered table's Iceberg metadata and metadata-file location. Choose a table returned by List tables; an unregistered table returns 404. The example path is illustrative and does not mean that table has been published. The catalog does not vend S3 credentials. This metadata endpoint is free and requires no API key. Reads of the underlying files through the S3 endpoint are separate and use your project credentials.

GET

https://iceberg.s3.pinax.network/v1/namespaces/{namespace}/tables/{table}

Free Preview

Required parameters

Name	Type	Description
namespacerequired path	string	A network namespace returned by List namespaces. The public catalog uses a single flat name, such as `eth`. e.g. eth
tablerequired path	string	A table name returned by List tables. `blocks` is an illustrative identifier; an unregistered table returns 404. e.g. blocks

Code example

1curl 'https://iceberg.s3.pinax.network/v1/namespaces/eth/tables/blocks' \
2  -H 'Accept: application/json'

Response

200 OK

metadata-locationstring

The S3 location of the Iceberg metadata JSON file.

metadataobject

Iceberg table metadata, including its actual storage location, schemas and snapshots.

format-versioninteger

table-uuidstring

locationstring

schemasarray<object>

current-snapshot-idinteger

snapshotsarray<object>

configobject