---
title: "Overview"
method: GET
path: "/ca/parcels/query"
tags: ["Canada"]
---

# Overview

`GET /ca/parcels/query`

The Regrid API offers a flexible and dynamic set of features for querying Regrid Parcels by numerous fields,  operators, geometries and allows for simple composition of API calls, from the output of one endpoint, to the  input of another. Multiple fields can be used in a single query (up to 4), to refine results. [<i>See full list of fields</i>](https://support.regrid.com/api/international-api). Check out Sample Use Case Scenarios in this section

## Query parameters

- `fields[:field_name][:operator]` string
- `geojson` string
- `offset_id` integer
- `radius` integer
- `limit` integer
- `path` string
- `return_count` boolean
- `return_geometry` boolean
- `return_custom` boolean
- `return_field_labels` boolean
- `return_stacked` boolean

## Response `200`

A list of parcel features.

- SimpleResponse
  - `parcels` object
    - `type` string
    - `features` object[]
      - `type` string
      - `geometry` union
        - object, nullable — GeoJSon object The coordinate reference system for all GeoJSON coordinates is a geographic coordinate reference system, using the World Geodetic System 1984 (WGS 84) datum, with longitude and latitude units of decimal degrees. This is equivalent to the coordinate reference system identified by the Open Geospatial Consortium (OGC) URN An OPTIONAL third-position element SHALL be the height in meters above or below the WGS 84 reference ellipsoid. In the absence of elevation values, applications sensitive to height or depth SHOULD interpret positions as being at local ground or sea level.
          - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon', required
          - `bbox` number[]
          - `coordinates` LinearRing[], required
            - Position[] — A linear ring is a closed LineString with four or more positions. The first and last positions are equivalent, and they MUST contain identical values; their representation SHOULD also be identical. A linear ring is the boundary of a surface or the boundary of a hole in a surface. A linear ring MUST follow the right-hand rule with respect to the area it bounds, i.e., exterior rings are counterclockwise, and holes are clockwise.
              - …
        - object, nullable — GeoJSon object The coordinate reference system for all GeoJSON coordinates is a geographic coordinate reference system, using the World Geodetic System 1984 (WGS 84) datum, with longitude and latitude units of decimal degrees. This is equivalent to the coordinate reference system identified by the Open Geospatial Consortium (OGC) URN An OPTIONAL third-position element SHALL be the height in meters above or below the WGS 84 reference ellipsoid. In the absence of elevation values, applications sensitive to height or depth SHOULD interpret positions as being at local ground or sea level.
          - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon', required
          - `bbox` number[]
          - `coordinates` array[], required
            - LinearRing[]
              - …
      - `properties` object
        - `headline` string — A human-friendly display address for the parcel. If no address is available, it falls back to the parcel number.
        - `path` string — The parcel's unique identifier
        - `fields` object — Standard Schema keys and values. Columns from the parcel table. These include standard column names wherever fields are available, plus additional columns varying by the particular county & data available.
        - `field_labels` object — Human-friendly labels for each key in fields
        - `context` object — A bit of info about the city or county where this parcel is found, including a path one can use as context for further searches.
        - `ll_uuid` string
      - `ll_uuid` string

## Other responses

- `400` — Invalid requests return informative 400 error
- `401` — Unauthorized

---

[API](https://skmtc.net/regrid/apis/regrid-openapi-specification.md) · [All operations](https://skmtc.net/regrid/apis/regrid-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/regrid/regrid-openapi-specification/versions/e4abb9a7fcfe/schema)