---
title: "Get one Cartographic Transformation"
method: POST
path: "/ct"
tags: ["Cartographic Transformations"]
---

# Get one Cartographic Transformation

`POST /ct`

Get one cartographic transformation given its essence

## Query parameters

- `mode` string

## Headers

- `data-partition-id` string, required

## Request body

- CTRequest — Request to get one cartographic transformation given its 'persistableReference' (serialized essence) or 'essence' structure. Only one, persistableReference or essence must be provided. If both are provided, essence takes precedence.
  - `persistableReference` string — The persistable reference string, either the essence of the cartographic transform (CT) serialized into a JSON string or an encoded string (version 1).
  - `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.

## Response `200`

A successful response

- CT — Generic cartographic transformation.
  - `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.

## 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/versions/563f9758ad2b/schema)