---
title: "Search CRSes"
method: POST
path: "/search/crs"
tags: ["Coordinate Reference Systems"]
---

# Search CRSes

`POST /search/crs`

Search CRS records (any sub-type) by keywords and/or geographic area. Geographical constraints are passed (optionally) as parameters via the query URL, search keywords are passed via the request body. Query syntax follows Lucene style, default operator for multiple expressions is AND. The following keywords are supported: 'name:', 'description:', 'type:', 'authority:', 'code:', 'deprecationState:', 'remarks:', 'lastModified:', 'source:', 'wellKnownText:', 'crsType:', 'baseCRS.authority:', 'baseCRS.code:', 'horizontalCRS.authority:', 'horizontalCRS.code:', 'verticalCRS.authority:', 'verticalCRS.code:', 'lateBoundCRS.authority:', 'lateBoundCRS.code:', 'ct.authority:', 'ct.code:', 'transformationReady:'. followed by a value. Example: 'transformationReady:true'. longitudeLeft - the left WGS 84 longitude limit of the search box. latitudeLower - the lower WGS 84 latitude limit of the search box. longitudeRight - the right WGS 84 longitude limit of the search box. latitudeUpper - The upper WGS 84 latitude limit of the search box.

## Query parameters

- `longitudeLeft` number, double
- `latitudeLower` number, double
- `longitudeRight` number, double
- `latitudeUpper` number, double
- `offset` integer
- `limit` integer
- `mode` string

## Headers

- `data-partition-id` string, required

## Request body

- SearchCRSRequest — Request to containing a Lucene style query string.
  - `query` string — The Lucene style query string with keywords.

## Response `200`

A successful response

- CRSResults — A response containing a list of CRSes.
  - `crses` CRS[] — An array of (any sub-type of) CRS
    - `essence` AnyCRSEssence — Any coordinate reference system essence carrying all possible properties for LateBoundCRSEssence, EarlyBoundCRSEssence and CompoundCRSEssence.
      - `type` 'LBC' | 'EBC' | 'CC', required — The type identifier.
      - `name` string, required — The name of the coordinate reference system.
      - `ver` string — The engine version issuing the definition.
      - `wkt` string — Well-known text (Esri style) of the late-bound coordinate reference system.
      - `lateBoundCRS` LateBoundCRSEssence — Late-bound coordinate reference system, i.e. a CRS without a transformation binding to WGS 84.
        - `type` 'LBC', required — The type identifier, fixed to 'LBC'.
        - `name` string, required — The name of the late-bound coordinate reference system.
        - `ver` string — The engine version issuing the definition.
        - `wkt` string, required — Well-known text (Esri style) of the late-bound coordinate reference system.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `singleCT` SingleCTEssence — Single cartographic transformation.
        - `type` 'ST', required — The type identifier, fixed to 'ST'.
        - `name` string, required — The name of the simple cartographic transformation.
        - `ver` string — The engine version issuing the definition.
        - `wkt` string, required — The well-known text (Esri style) defining this transformation.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `compoundCT` CompoundCTEssence — Compound cartographic transformation.
        - `type` 'CT', required — The type identifier, fixed to 'CT'.
        - `name` string, required — The name of the compound cartographic transformation.
        - `ver` string — The engine version issuing the definition.
        - `policy` 'Fallback' | 'Concatenated', required — The transformation policy - concatenated or fallback.
        - `cts` SingleCTEssence[], required — The ordered list of cartographic transformations.
          - `type` 'ST', required — The type identifier, fixed to 'ST'.
          - `name` string, required — The name of the simple cartographic transformation.
          - `ver` string — The engine version issuing the definition.
          - `wkt` string, required — The well-known text (Esri style) defining this transformation.
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `horzLateBoundCRS` LateBoundCRSEssence — Late-bound coordinate reference system, i.e. a CRS without a transformation binding to WGS 84.
        - `type` 'LBC', required — The type identifier, fixed to 'LBC'.
        - `name` string, required — The name of the late-bound coordinate reference system.
        - `ver` string — The engine version issuing the definition.
        - `wkt` string, required — Well-known text (Esri style) of the late-bound coordinate reference system.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `horzEarlyBoundCRS` EarlyBoundCRSEssence — Early-bound coordinate reference system, i.e. a CRS with a transformation binding to WGS 84
        - `type` 'EBC', required — The type identifier, fixed to 'EBC'.
        - `name` string, required — The name of the early-bound coordinate reference system.
        - `ver` string — The engine version issuing the definition.
        - `lateBoundCRS` LateBoundCRSEssence, required — Late-bound coordinate reference system, i.e. a CRS without a transformation binding to WGS 84.
          - `type` 'LBC', required — The type identifier, fixed to 'LBC'.
          - `name` string, required — The name of the late-bound coordinate reference system.
          - `ver` string — The engine version issuing the definition.
          - `wkt` string, required — Well-known text (Esri style) of the late-bound coordinate reference system.
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `singleCT` SingleCTEssence — Single cartographic transformation.
          - `type` 'ST', required — The type identifier, fixed to 'ST'.
          - `name` string, required — The name of the simple cartographic transformation.
          - `ver` string — The engine version issuing the definition.
          - `wkt` string, required — The well-known text (Esri style) defining this transformation.
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `compoundCT` CompoundCTEssence — Compound cartographic transformation.
          - `type` 'CT', required — The type identifier, fixed to 'CT'.
          - `name` string, required — The name of the compound cartographic transformation.
          - `ver` string — The engine version issuing the definition.
          - `policy` 'Fallback' | 'Concatenated', required — The transformation policy - concatenated or fallback.
          - `cts` SingleCTEssence[], required — The ordered list of cartographic transformations.
            - `type` 'ST', required — The type identifier, fixed to 'ST'.
            - `name` string, required — The name of the simple cartographic transformation.
            - `ver` string — The engine version issuing the definition.
            - `wkt` string, required — The well-known text (Esri style) defining this transformation.
            - `authCode` AuthCode — The AuthorityCode for this item.
              - …
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `vertLateBoundCRS` LateBoundCRSEssence — Late-bound coordinate reference system, i.e. a CRS without a transformation binding to WGS 84.
        - `type` 'LBC', required — The type identifier, fixed to 'LBC'.
        - `name` string, required — The name of the late-bound coordinate reference system.
        - `ver` string — The engine version issuing the definition.
        - `wkt` string, required — Well-known text (Esri style) of the late-bound coordinate reference system.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `vertEarlyBoundCRS` EarlyBoundCRSEssence — Early-bound coordinate reference system, i.e. a CRS with a transformation binding to WGS 84
        - `type` 'EBC', required — The type identifier, fixed to 'EBC'.
        - `name` string, required — The name of the early-bound coordinate reference system.
        - `ver` string — The engine version issuing the definition.
        - `lateBoundCRS` LateBoundCRSEssence, required — Late-bound coordinate reference system, i.e. a CRS without a transformation binding to WGS 84.
          - `type` 'LBC', required — The type identifier, fixed to 'LBC'.
          - `name` string, required — The name of the late-bound coordinate reference system.
          - `ver` string — The engine version issuing the definition.
          - `wkt` string, required — Well-known text (Esri style) of the late-bound coordinate reference system.
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `singleCT` SingleCTEssence — Single cartographic transformation.
          - `type` 'ST', required — The type identifier, fixed to 'ST'.
          - `name` string, required — The name of the simple cartographic transformation.
          - `ver` string — The engine version issuing the definition.
          - `wkt` string, required — The well-known text (Esri style) defining this transformation.
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `compoundCT` CompoundCTEssence — Compound cartographic transformation.
          - `type` 'CT', required — The type identifier, fixed to 'CT'.
          - `name` string, required — The name of the compound cartographic transformation.
          - `ver` string — The engine version issuing the definition.
          - `policy` 'Fallback' | 'Concatenated', required — The transformation policy - concatenated or fallback.
          - `cts` SingleCTEssence[], required — The ordered list of cartographic transformations.
            - `type` 'ST', required — The type identifier, fixed to 'ST'.
            - `name` string, required — The name of the simple cartographic transformation.
            - `ver` string — The engine version issuing the definition.
            - `wkt` string, required — The well-known text (Esri style) defining this transformation.
            - `authCode` AuthCode — The AuthorityCode for this item.
              - …
          - `authCode` AuthCode — The AuthorityCode for this item.
            - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
            - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
      - `authCode` AuthCode — The AuthorityCode for this item.
        - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
        - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
    - `crstype` string — The type of ths CRS.
    - `source` string — The source of ths CRS.
    - `transformationReady` boolean — The Transformation readiness of this CRS.
    - `baseCRSAuthorityCode` AuthCode — The AuthorityCode for this item.
      - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
      - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
    - `aliasNames` string[] — Alias names for this CRS.
    - `axisUnits` string[] — Axis Unit Essences.
    - `numberOfAxes` integer — The NumberOfAxes of this CRS.
    - `description` string — The description of this CRS.
    - `lastModified` string — The LastModified of this CRS.
    - `areaOfUse` AreaOfUse — The AreaOfUse class.
      - `id` string — The Internal Id of the AreaOfUse.
      - `name` string — The name of the AreaOfUse.
      - `description` string — The description of the AreaOfUse.
      - `lastModified` string — The LastModified of the AreaOfUse.
      - `namedReference` NamedReference — Name and Persistable Reference (the essence converted to a JSON string).
        - `name` string — The name of the item.
        - `persistableReference` string — The item 'essence' serialized into a JSON string.
      - `essence` AreaOfUseEssence — Area of use consisting of a bounding box in latitude and longitude WGS 84.
        - `type` 'AOU', required — The type identifier, fixed to 'AOU'.
        - `boundBox` BoundBox, required — WGS 84 bounding box in latitude longitude.
          - `lonMin` number, required — The left longitude limit in degrees; the longitude can wrap around the datum line.
          - `lonMax` number, required — The right longitude limit in degrees; the longitude can wrap around the datum line.
          - `latMin` number, required — The upper latitude limit in degrees.
          - `latMax` number, required — The lower latitude limit in degrees.
        - `authCode` AuthCode — The AuthorityCode for this item.
          - `auth` string, required — The name of the authority issuing the code. Usually a string but it can be NULL for transient items.
          - `code` string, required — The code issued by the authority. Usually a number but it can be NULL for transient items.
    - `deprecationInfo` CRSDeprecationInfo — Deprecation information for a coordinate reference system.
      - `deprecationState` string — State - one of {identical, corrected, unresolved}
      - `remarks` string — Further explanation of the deprecation.
      - `supersededByCRS` CRS — recursive
    - `namedReference` NamedReference — Name and Persistable Reference (the essence converted to a JSON string).
      - `name` string — The name of the item.
      - `persistableReference` string — The item 'essence' serialized into a JSON string.
  - `count` integer — Number of elements in the response.
  - `offset` integer — Offset to the first catalog item in the response, as set in the request.
  - `totalCount` integer — Number of elements in the catalog.

## Other responses

- `400` — Bad input format
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/slb/apis/crs-catalog-service-api.md) · [All operations](https://skmtc.net/slb/apis/crs-catalog-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slb/crs-catalog-service-api/revisions/72df7eed91b2/schema)
