Retrieve plot details

Request

Fetches details of a specific plot by its unique plot_id

Security

BearerAuth

Path

plot_idstringrequired

Authorizationstring

Authorization header with a Bearer token, formatted as 'Bearer [JWT]' where [JWT] is the JSON Web Token used for user authentication and authorization.

Example:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.your-payload-here.signature

GET

/plots/plot/{plot_id}

curl -i -X GET \
  'https://api.open-atlas.com/_mock/openapi/plots/plot/{plot_id}' \
  -H 'Authorization: Bearer <YOUR_JWT or vantage_live_ API key_HERE>'

Responses

Plots details retrieved successfully

Bodyapplication/json

usernamestring

Username of the account that created the plot, the plot owner

Example:"jdoe"

countrystring

Country where the plot is located

Example:"United States"

statestring

State or region where the plot is located

Example:"California"

notesstring

Additional notes related to the plot

Example:"This plot requires frequent irrigation."

analysisobject(Analysis)

Complete analysis data for a plot. Legacy top-level fields (risk_level, deforestation, forest_*, etc.) are written by the EUDR bundle for backwards compatibility; the same data is also available under the eudr key. Every other analysis capability writes its result under a key matching the capability name (e.g. soil_moisture, flood_risk_5years, solar_site_suitability) using the standard capability result envelope, except where a dedicated schema is documented (visual_verification, deforestation_analysis, GEE checks). The protected_area check writes under protected_areas and the indigenous_land check under indigenous_land.

plot_idstring

Unique identifier for the plot

Example:"ef6f5727-377f-4e9d-abcb-74a8a6bf0366"

plot_namestring

Name of the plot

Example:"East Field"

geojson_featuresArray of objects(GeoJsonFeature)

harvest_datesArray of strings

commoditystring

Type of commodity planted in the plot to do analysis on

Enum:"wood""soy""cocoa""coffee""palm_oil""beef""rubber"

Example:"cocoa"

latstring

Latitude of the plot's center

Example:"34.052235"

lonstring

Longitude of the plot's center

Example:"-118.243683"

area_hanumber, (double)

Area of the plot in hectares

Example:12.5

tokens_costinteger, (int32)

Cost of the analyzing the plot in tokens

Example:150

created_atstring, (date-time)

Timestamp of plot creation

updated_atstring, (date-time)

Timestamp of the last plot update

analysis_imagestring

URL for the visualization of the analysis of the plot

Example:"https://example.com/images/plot-analysis.jpg"

additional_infoobject

Additional information about the plot as key-value pairs

Example:

{
  "soil_quality": "high",
  "access": "restricted"
}

Response

{
  "username": "jdoe",
  "country": "United States",
  "state": "California",
  "notes": "This plot requires frequent irrigation.",
  "analysis": {
    "analysisEnd": "2024-02-29",
    "analysis_end": "2024-02-29",
    "risk_level": "Low",
    "forest_percentage_2020": 93.07,
    "indigenous_land": { … },
    "logging_area": 1.08,
    "forest_area_2020": 145.31,
    "risk_reason": "Low: Low deforestation detection",
    "version": "2026-08-11",
    "areaHa": 156.13,
    "area_ha": 156.13,
    "analyzed_area_ha": 156.13,
    "protected_areas": { … },
    "deforestation": { … },
    "deforestation_percentage": 0.044,
    "eudr": { … },
    "deforestation_analysis": { … },
    "visual_verification": { … },
    "land_cover": { … },
    "surface_temperature": { … },
    "precipitation": { … },
    "water_detection": { … },
    "fire_damage": { … },
    "protectedAreas": [ … ],
    "indigenous_overlap": { … },
    "property1": { … },
    "property2": { … }
  },
  "plot_id": "ef6f5727-377f-4e9d-abcb-74a8a6bf0366",
  "plot_name": "East Field",
  "geojson_features": [
    { … }
  ],
  "harvest_dates": [
    "2024-11-01"
  ],
  "commodity": "cocoa",
  "lat": "34.052235",
  "lon": "-118.243683",
  "area_ha": 12.5,
  "tokens_cost": 150,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "analysis_image": "https://example.com/images/plot-analysis.jpg",
  "additional_info": {
    "soil_quality": "high",
    "access": "restricted"
  }
}