---
title: "/v4 /coverage.json"
method: POST
path: "/coverage.json"
tags: ["coverage"]
---

# /v4 /coverage.json

`POST /coverage.json`

Returns survey resources at a particular location, filtered by date.

## Query parameters

- `polygon` string
- `point` string
- `since` string
- `until` string
- `bulk` boolean
- `prerelease` boolean
- `perspective` string
- `3dCoverage` boolean
- `systemVersion` string
- `systemVersionPrefix` string
- `excludePartialResources` boolean
- `postcat` 'true' | 'false' | 'any'

## Request body

- object
  - `aoi` object — A GeoJSON object representing the requested AOI. Must be a GeoJSON polygon with no interior rings. It cannot be used with the `polygon` query parameter.
    - `type` 'Polygon' — GeoJSON geometry type.
    - `coordinates` GeoJSONPolygonRing[] — The collection of rings defining the Polygon.
      - GeoJSONCoordinate[] — A collection of coordinate pairs that define the Polygon ring.
        - number[] — An ordered pair of floating point numbers in the following sequence: longitude, latitude.
  - `classes` string[] — Classes accepts a list of class IDs. Features classes not requested will be filtered out of the response. The full list of available feature classes can be obtained by using the `classes.json` endpoint (Feature class IDs are in the `id` field for classes of type `Feature`). The response will include all feature classes that the user is entitled to if the query or body parameter is not specified. It cannot be used with the `packs` query parameter. This parameter is ignored if used with an empty value. It cannot be used with the `classes` query parameter.

## Response `200`

OK

- CoverageResult
  - `result` object[], required
    - `id` string, required — The ID of the survey resource.
    - `surveyId` string, required — ID of the survey associated with the survey resource.
    - `captureDate` string, date, required — The capture date of the survey associated with the survey resource.
    - `systemVersion` string, required — The system version of the survey resource.
    - `perspective` 'Vert' | 'TrueOrtho', required — The perspective of the survey resource.
    - `classes` object[], required — The list of classes available in the survey resource. This includes both feature classes and attribute classes.
      - `id` string, required — The class ID. Details about the class are available via the `classes.json` endpoint.
    - `partial` boolean — Indicates that the resource only has prediction generated in certain areas. While it may have coverage in the AOI, it may not have coverage in other areas of the survey boundary.

## Other responses

- `400` — Bad request. There was a problem with the request parameters.
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/nearmap/apis/tiles.md) · [All operations](https://skmtc.net/nearmap/apis/tiles/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nearmap/tiles/revisions/1f55d21ac4b9/schema)