Load namespace

FREE

Read one network namespace and its properties. The namespace's location is a catalog default, not a table's storage path; read each table's metadata for its actual location. Returns 404 if the namespace does not exist. 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}

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

Code example

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

Response

200 OK

{
  "namespace": [
    "eth"
  ],
  "properties": {
    "location": "s3://eth/eth"
  }
}