---
title: "Describe table schema and properties"
method: GET
path: "/v1/spatial/tables/{tableName}/metadata"
tags: ["Data Exploration"]
---

# Describe table schema and properties

`GET /v1/spatial/tables/{tableName}/metadata`

## Request

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

Retrieve detailed metadata for a single table including column definitions, geometry type, spatial bounds, row count, data types, and supported operations (insert/update/delete). Prerequisites: table must exist; caller requires READ permission on the table.

## Path parameters

- `tableName` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Successful retrieval of metadata of a table

- 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)