---
title: "Describe multiple table schemas"
method: POST
path: "/v1/spatial/tables/metadata"
tags: ["Data Exploration"]
---

# Describe multiple table schemas

`POST /v1/spatial/tables/metadata`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/spatial/tables/metadata`
- Auth: one of:
  - `bearerAuth` (a scheme the document does not define)
  - `ApiKeyAuth` (a scheme the document does not define)

Retrieve detailed metadata for multiple tables in a single batch request. Returns an entry for each table with full schema including columns, geometry, bounds, and capabilities. Tables that cannot be resolved include an errorMessage in their response entry. Prerequisites: caller requires READ permission on each requested table.

## Headers

- `X-Request-Id` string

## Request body

- DescribeTablesRequest
  - `tableNames` string[], required

## Response `200`

Successful retrieval of metadata for requested tables

- DescribeTablesResponse
  - `tableList` TableMetadataResponse[]
    - `tableName` string
    - `geometryType` string
    - `numberOfRows` integer
    - `columns` ColumnMetadata[]
      - `columnName` string
      - `dataType` string
      - `queryable` boolean
      - `styleColumn` string
      - `fractionalDigits` integer
      - `totalDigits` integer
    - `key` KeyMetadata
      - `kind` string
      - `columns` string[]
    - `capabilities` TableCapabilities
      - `insert` boolean
      - `update` boolean
      - `delete` boolean
    - `geoHashIndexMetadata` GeoHashIndexMetadata
      - `maxScale` number, double
      - `minScale` number, double
      - `latitude` number, double
      - `geoHashIndexColumn` string
      - `precision` integer
      - `copy` GeoHashIndexMetadata (recursive)
    - `rasterMetadata` RasterMetadataResponse
      - `width` integer
      - `height` integer
      - `supportsGridCellValue` boolean
      - `fields` RasterFieldMetadata[]
        - `name` string
        - `type` string
        - `bands` RasterBandMetadata[]
          - `name` string
          - `type` string
          - `dataType` string
          - `mapInfoUnits` string
    - `viewTableMetadata` ViewTableMetadataResponse
      - `referencedTables` string[]
      - `boundParameters` BoundParameterMetadata[]
        - `name` string
        - `description` string
        - `dataType` string
        - `value` string
    - `errorMessage` string
    - `xMin` number, double
    - `xMax` number, double
    - `yMin` number, double
    - `yMax` number, double

## Other responses

- `400`: Invalid request
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/feature-api.md) · [All operations](https://skmtc.dev/precisely/apis/feature-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/feature-api/revisions/6dc26f89c0aa?raw)