---
title: "Get one CRS"
method: POST
path: "/crs"
tags: ["Coordinate Reference Systems"]
---

# Get one CRS

`POST /crs`

Get one CRS (any sub-type) given its essence

## Query parameters

- `mode` string

## Headers

- `data-partition-id` string, required

## Request body

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

- CRS — Generic coordinate reference system, either a late-bound, early-bound CRS or compound 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.
            - `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.
    - `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.
            - `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.
    - `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.

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