# Get plots information

This endpoint can be useful in many different situations:
* Downloading metadata for your plots from the platform
* Downloading plot geometries from the platform
* Getting plot-level risk assessments from the platform

It is paginated and returns 200 plots at a time. Use the  returned in the response to fetch the next page of results.


Endpoint: GET /v1/plots
Version: v1
Security: bearerAuth

## Query parameters:

  - `projectId` (string)
    Project ID (optional, defaults to user's 'active project')

  - `supplier` (string)
    Filters plots to those belonging to the supplier with the given satelligence ID.

  - `supplierName` (string)
    Filters plots to those belonging to the supplier with the given name.

  - `plotName` (string)
    Filters plots to those with this name.

  - `withGeometry` (boolean)
    Whether to include geometry data for each plot. Defaults to false.

  - `cursor` (string)
    Optional pagination cursor for fetching a subsequent page of results.

  - `hasSatelliteMonitoring` (boolean)
    Filters plots to those with or without satellite monitoring.

## Response 200 fields (application/json):

  - `plots` (array)

  - `plots.id` (string)
    Internal satelligence identifier for the plot.

  - `plots.name` (string,null)
    User provided name of the plot.

  - `plots.supplierId` (string)
    Internal satelligence supplier ID associated with the plot.

  - `plots.supplierName` (string)
    Supplier name associated with the plot.

  - `plots.hasSatelliteMonitoring` (boolean,null)
    Whether satellite monitoring is available for this plot. If the plot is not in your monitoring region, this will be false, and risk information will not be available.

  - `plots.assessmentInfo` (any)
    Risk assessment information for a plot, can be either a status string or complete risk data.

  - `plots.center` (array,null)
    Lng/lat coordinates for the plot. This is not exactly the center or the centroid, but the pole of inaccessibility.

  - `plots.umlIds` (array,null)
    UML IDs associated with the plot.

  - `plots.producerName` (string,null)
    User provided , if given.

  - `plots.producerCountry` (string,null)
    User provided , if given.

  - `plots.geometry` (object,null)
    GeoJSON MultiPolygon geometry of the plot, if  is true.

  - `plots.extraProperties` (object,null)
    Any user provided properties you may have given when uploading the plot.

  - `nextUrl` (string,null)
    URL to fetch the next page of results, null if no more result are available.