---
title: "Get one Area of Use"
method: POST
path: "/area"
tags: ["Areas of Use"]
---

# Get one Area of Use

`POST /area`

Get one Area of Use record by essence - returning a named bounding box definition in latitude and longitude.

## Query parameters

- `mode` string

## Headers

- `data-partition-id` string, required

## Request body

- AreaOfUseRequest — Request to get area of use
  - `persistableReference` string — The persistable reference string, either the essence of the AreaOfUse serialized into a JSON string or an encoded string (version 1).
  - `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.

## Response `200`

A successful response

- 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.

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