---
title: "Calculates classification ranges over a numeric expression for a named table, optionally filtered"
method: POST
path: "/v1/spatial/internal/tables/ranges"
tags: ["Spatial Analysis"]
---

# Calculates classification ranges over a numeric expression for a named table, optionally filtered

`POST /v1/spatial/internal/tables/ranges`

## Request

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

Same as GET /v1/spatial/internal/tables/ranges but additionally accepts an optional JSON body restricting which rows are used to compute ranges, e.g. {"filterCondition": "Country='US'", "parameters": [...]}. Filtering is supported only when type is EqualRange, EqualCount, or StandardDeviation.

## Query parameters

- `tableName` string, required
- `expression` string
- `type` string
- `numRanges` integer, required
- `roundBy` number
- `quantileExpr` string
- `ignoreZero` boolean

## Headers

- `X-Request-Id` string

## Request body

- string

## Response `200`

Successfully calculated the named table ranges

- RangeBinList
  - `rangeBin` RangeBin[], required
    - `upperBound` unknown, required
    - `lowerBound` unknown, required
    - `style` union, required
      - AbstractStyle
        - `type` string, required
      - object
        - `type` string, required
        - `inflections` Inflection[]
          - `color` object
            - `rgb` integer
            - `red` integer
            - `green` integer
            - `blue` integer
            - `alpha` integer
            - `colorSpace` object
              - …
            - `transparency` integer
          - `name` string
          - `value` InflectionValue
            - `double` number, double
            - `type` 'DOUBLE' | 'STRING'
            - `string` string
          - `copy` Inflection (recursive)
      - object
        - `type` string, required
        - `name` string, required
      - object
        - `type` string, required
        - `PointStyle` MapBasicPointStyle
          - `MapBasicSymbol` IMapBasicSymbolProperties
            - `color` object
              - …
            - `size` integer
        - `LineStyle` MapBasicLineStyle
          - `MapBasicPen` MapBasicPenProperties
            - `color` object
              - …
            - `width` integer
            - `pattern` integer
        - `AreaStyle` MapBasicAreaStyle
          - `MapBasicPen` MapBasicPenProperties
            - `color` object
              - …
            - `width` integer
            - `pattern` integer
          - `MapBasicBrush` MapBasicBrushProperties
            - `foregroundColor` object
              - …
            - `backgroundColor` object
              - …
            - `pattern` integer
        - `TextStyle` MapBasicTextStyle
          - `MapBasicFontStyle` MapBasicFontStyle
            - `fontName` string, required
            - `style` integer, required
            - `size` integer, required
            - `opacity` number
            - `backgroundOpacity` number
            - `foregroundColor` object, required
              - …
            - `backgroundColor` object, required
              - …
        - `RasterStyle` MapBasicRasterStyle
          - `type` string, required
          - `opacity` number
          - `brightness` number
          - `isTransparentColorEnabled` boolean
          - `transparentColor` string
          - `contrast` number
          - `isGrayScale` boolean
        - `GridStyle` MapBasicGridStyle
          - `opacity` number
          - `brightness` number
          - `contrast` number
          - `isGrayScale` boolean
          - `showHillShade` boolean
          - `nullColor` object
            - `rgb` integer
            - `red` integer
            - `green` integer
            - `blue` integer
            - `alpha` integer
            - `colorSpace` object
              - …
            - `transparency` integer
          - `isNullTransparent` boolean
          - `renderStyle` RenderStyle
            - `type` string, required
            - `underviewInterpolation` string
            - `enableAlpha` boolean
            - `Hillshade` Hillshade
              - …
            - `components` Component[]
              - …
            - `dataTransforms` DataTransform[]
              - …
            - `hillshade` Hillshade
              - …
          - `inflections` Inflection[]
            - `color` object
              - …
            - `name` string
            - `value` InflectionValue
              - …
            - `copy` Inflection (recursive)
      - object
        - `type` string, required
        - `opacity` number
        - `brightness` number
        - `isTransparentColorEnabled` boolean
        - `transparentColor` string
        - `contrast` number
        - `isGrayScale` boolean

## Other responses

- `400`: Invalid request
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `404`: Table not found
- `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)