Tables

Get table schema

Retrieves the current logical schema of the Iceberg table. Information provided: - Field IDs used by Iceberg to track columns across renames. - Data types such as string, long, struct, date, timestamp. - Nullability for each field. Example Usage: ```bash curl -X GET '/namespaces/sales.emea/tables/orders/schema' ```

Last updated on

GET
/namespaces/{namespace}/tables/{tableName}/schema

Path Parameters

namespace*string
tableName*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/namespaces/string/tables/string/schema"
{
  "success": true,
  "data": {
    "table_identifier": "string",
    "schema": {
      "type": "string",
      "fields": [
        {
          "id": 0,
          "name": "string",
          "type": "string",
          "required": true
        }
      ],
      "schema-id": 0,
      "identifier-field-ids": [
        0
      ]
    }
  }
}
{
  "error": "string",
  "error_code": "string"
}
{
  "message": "string",
  "error_code": "string"
}
{
  "detail": [
    {
      "loc": [
        null
      ],
      "msg": "string",
      "type": "string",
      "input": "string",
      "ctx": {
        "property1": null,
        "property2": null
      }
    }
  ]
}
{
  "error": "string",
  "error_code": "string"
}
{
  "error": "string",
  "error_code": "string"
}

See also

How is this guide?

Retrieve namespace details GET

Fetches metadata for a specific namespace. Returns the namespace identifier together with its immediate child namespaces, tables, and files. Example Usage: ```bash curl -X GET '/namespaces/my_org.data_warehouse' ```

Query table rows POST

Queries table rows as JSON with optional column selection, filtering, sorting and offset pagination. Returns the matching rows plus pagination metadata: total, total_pages and current_page. The query is sent as a JSON request body — see the fields below, and the Querying guide for the full filter grammar and examples.