---
title: "Survey resource boundaries that intersect with a polygon"
method: GET
path: "/surveyresources/boundaries.{fileFormat}"
tags: ["coverage boundaries"]
---

# Survey resource boundaries that intersect with a polygon

`GET /surveyresources/boundaries.{fileFormat}`

## Request

- Base URL: `https://api.nearmap.com/coverage/v2`
- URL: `https://api.nearmap.com/coverage/v2/surveyresources/boundaries.{fileFormat}`
- Auth: one of:
  - API key in query parameter `apikey`
  - API key in header `Authorization`

Return all survey resources with boundaries that intersect with the given polygon specified in the path. Sorted by date in ascending order.

## Path parameters

- `fileFormat` 'geojson', required

## Query parameters

- `polygon` string
- `line` string
- `limit` integer
- `offset` integer
- `since` string
- `until` string
- `resources` string
- `overlap` string
- `include` string
- `exclude` string
- `sort` string

## Response `200`

Survey resources with boundaries matching criteria.

- ResourceFeatureCollection: Resources as GeoJSON FeatureCollection
  - `type` 'FeatureCollection'
  - `features` ResourceFeature[]: List of resources
    - `id` string: Resource id
    - `type` 'Feature'
    - `geometry` Geometry
      - `type` 'MultiPolygon': GeoJSON geometry object
      - `coordinates` array[]
        - array[]
          - Point[]
            - number[]: Point in 2D space
    - `properties` object
      - `type` string: Type of the survey resource
      - `resourceClass` '3d' | 'photos' | 'predictionRasters' | 'aifeatures' | 'tiles': Resource class
      - `scale` integer: Highest native zoom size of the resource (or zero if not applicable)
      - `surveyID` string: Survey id
      - `captureDate` string: Date that survey was captured on, in the format "YYYY-MM-DD"
      - `firstPhotoTime` string: Date and time in UTC of the first photo taken in the survey
      - `lastPhotoTime` string: Date and time in UTC of the last photo taken in the survey
      - `onlineTime` string: Date and time in UTC when the survey became available online
      - `pixelSize` integer: Ground sample distance in meters
      - `timezone` string: Universal timezone abbreviation of the location of the survey
      - `utcOffset` integer: Difference in minutes between UTC and the local timezone
      - `country` string: Country code of the survey
      - `region` string: City or a locale in which the survey is situated
      - `state` string: State containing the survey
  - `limit` integer: The limit of the total number of survey resources returned, as specified in the request
  - `offset` integer: The offset of the first survey resource to be displayed, as specified in the request
  - `total` integer: The total number of survey resources available for this request

## Other responses

- `400`: On bad input parameter or if polygon is invalid.
- `404`: On invalid fileformat input parameter.

---

[API](https://skmtc.dev/nearmap/apis/coverage.md) - [All operations](https://skmtc.dev/nearmap/apis/coverage/llms.txt) - [OpenAPI document](https://skmtc.dev/nearmap/apis/coverage/revisions/82449937f4df?raw)