---
title: "Search Cartographic Transformations"
method: POST
path: "/search/ct"
tags: ["Cartographic Transformations"]
---

# Search Cartographic Transformations

`POST /search/ct`

Search cartographic transform 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:', 'fromCRS.authority:', 'fromCRS.code:', 'toCRS.authority:', toCRS.code:', 'policy:'. followed by a value. Example: 'fromCRS.code:4267'. 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

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

## Response `200`

A successful response

- CTResults — A response containing a list of cartographic transformations.
  - `cts` CT[] — An array of (any sub-type of) cartographic transforms
    - `source` string — The source of the cartographic transformation.
    - `aliasNames` string[] — Alias names for this cartographic transformation.
    - `description` string — The description of the cartographic transformation.
    - `fromCRSAuthorityCode` 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.
    - `toCRSAuthorityCode` 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.
    - `lastModified` string — The LastModified of the cartographic transformation.
    - `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` CTDeprecationInfo — Deprecation information for a cartographic transform.
      - `deprecationState` string — State - one of {identical, corrected, unresolved}
      - `remarks` string — Further explanation of the deprecation.
      - `supersededByCT` CT — 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.
    - `essence` AnyCTEssence — Any sub-type of cartographic transformation.
      - `type` 'ST' | 'CT', required — The type identifier, either 'ST' or 'CT'.
      - `name` string, required — The name of the simple cartographic transformation.
      - `ver` string — The engine version issuing the definition.
      - `wkt` string — The well-known text (Esri style) defining this transformation.
      - `policy` 'Fallback' | 'Concatenated' — The transformation policy - concatenated or fallback.
      - `cts` SingleCTEssence[] — 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.
  - `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/563f9758ad2b/schema)