---
title: "Search Areas of Use"
method: POST
path: "/search/area"
tags: ["Areas of Use"]
---

# Search Areas of Use

`POST /search/area`

Search Area of Use records by keywords and/or geographic area - returning named bounding box definitions in latitude and longitude. 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:', 'authority:', 'code:', 'deprecationState:', 'remarks:' (deprecationState remarks), 'lastModified:'. Example 'name:*America*'. 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

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

## Response `200`

A successful response

- AreaOfUseResults — A response containing a list of areas of use.
  - `areasOfUse` AreaOfUse[] — An array of AreaOfUse
    - `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.
  - `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)