--- title: "Guide: How to integrate with Monitor API" description: Learn how to integrate with Monitor API, make requests for on-field practice insights and retrieve field data. --- [Skip to content](https://help.regrow.ag/guide-how-to-integrate-with-monitor-api#main-content) English Show submenu for translations [Customer portal](https://help.regrow.ag/support?hsLang=en) ![Regrow\_logo-1.png\]](https://help.regrow.ag/hs-fs/hubfs/03.%20Logos/Regrow_logo-1.png?height=40&name=Regrow_logo-1.png) Open main navigation Close main navigation - English Show submenu for translations - [Customer portal](https://help.regrow.ag/support) - [Go to regrow.ag](https://www.regrow.ag/) [Go to regrow.ag](https://www.regrow.ag/) How can we help you? - There are no suggestions because the search field is empty. 1. [Knowledge Base](https://help.regrow.ag/?hsLang=en) 2. [Monitor API](https://help.regrow.ag/monitor-api?hsLang=en) 3. [Integrate with Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#integrate-with-monitor-api) # Guide: How to integrate with Monitor API ## Learn how to integrate with Monitor API, make requests for on-field practice insights and retrieve field data. Monitor API enables access to the specific field and management data (such as crop cover, commodity crop type and tillage practices) needed to power sustainability programs and verify regenerative practices remotely.  The following sections of this article explain the detailed steps and tips for building an integration with Monitor API. If you are just getting started, watch this video for an overview of the integration process and helpful considerations. ### Step 1: Obtain field boundaries Before querying for field practices, you’ll first need to source the field boundaries. Monitor API accepts field boundaries in [GeoJSON format](https://datatracker.ietf.org/doc/html/rfc7946), with `polygon` or `multiPolygon` geometry objects. ``` "feature_collection": { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ [ [ [ -84.003914, 40.333411 ], [ -84.003874, 40.332533 ], [ -84.001319, 40.332512 ], [ -83.999221, 40.332527 ], [ -83.999265, 40.336911 ], [ -83.999274, 40.336991 ], [ -83.999379, 40.336994 ], [ -84.003959, 40.336751 ], [ -84.006094, 40.336645 ], [ -84.006047, 40.333394 ], [ -84.003914, 40.333411 ] ] ] ], "type": "MultiPolygon" } } ] } ``` ### Step 2: Submit a Request for Field Practices To make a request for agricultural practice data for a field, make a `POST` request to the [/processes/monitor-fields-geojson/execution](https://developers.regrow.ag/docs/monitor-v2/1/routes/processes/monitor-fields-geojson/execution/post) endpoint. Request Body In the request body you’ll provide a `feature-collection` object with GeoJSON field boundaries, as well as a date range. Use the date range to specify the time window you’d like to receive field practice data for. **Pro tip:** When querying practice data for multiple fields for the same date range, you can submit multiple field boundaries in one request. Each field boundary is represented as a `feature` object within the “features” array in the `feature collection`. ``` "feature_collection": { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ [] ], "type": "Polygon" } }, { "type": "Feature", "geometry": { "coordinates": [ [] ], "type": "Polygon" } } ] } ``` Monitor API runs an asynchronous process. You can optionally include callback URLS and header parameters to receive notifications when the process is complete and field data is ready to be retrieved. To do so, include a [subscriber](https://developers.regrow.ag/docs/monitor-v2/1/types/Subscriber) object in the request body. Alternatively, you can use the [/job-status](https://developers.regrow.ag/docs/monitor-v2/1/routes/jobs/%7Bjob_id%7D/get) endpoint to get the status of the process, or poll the [/results](https://developers.regrow.ag/docs/monitor-v2/1/routes/jobs/%7Bjob_id%7D/results/get) endpoint. Use the `job_id` from the response body of a successful request to check the status of the job or poll for results. ``` { "inputs": { "feature_collection": { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ [ [ [ -84.003914, 40.333411 ], [ -84.003874, 40.332533 ], [ -84.001319, 40.332512 ], [ -83.999221, 40.332527 ], [ -83.999265, 40.336911 ], [ -83.999274, 40.336991 ], [ -83.999379, 40.336994 ], [ -84.003959, 40.336751 ], [ -84.006094, 40.336645 ], [ -84.006047, 40.333394 ], [ -84.003914, 40.333411 ] ] ] ], "type": "MultiPolygon" } } ] }, "start_date": "2017-01-01", "end_date": "2017-12-31" }, "outputs": {}, "response": "document", "transmission_mode": "value", "subscriber": { "successUri": "string", "successHeaders": { "additionalProp1": "string", "additionalProp2": "string" }, "inProgressUri": "string", "inProgressHeaders": { "additionalProp1": "string", "additionalProp2": "string" }, "failedUri": "string", "failedHeaders": { "additionalProp1": "string", "additionalProp2": "string" } }} ``` ### Step 3: Retrieve Field Practice Data Once the job for a field request is complete, you can make a `GET` request to the [/results](https://developers.regrow.ag/docs/monitor-v2/1/routes/jobs/%7Bjob_id%7D/results/get) endpoint to retrieve practice data. Use the `job_id` returned from the original field request to specify which job to retrieve results for. Field data includes practice information on commodity crops, cover crops and tillage practices, as well as field metadata and the specified date range. **Pro Tip:** Store the `boundary-id` from the results response to use in subsequent data queries for the field. Once you have a `boundary-id` for a field, you can make subsequent requests for field practice data using the [/monitor-fields-boundary-id](https://developers.regrow.ag/docs/monitor-v2/1/routes/processes/monitor-fields-boundary-id/execution/post) endpoint instead of passing the field boundaries in GeoJSON format. Field practice data is available via the [/results](https://developers.regrow.ag/docs/monitor-v2/1/routes/jobs/%7Bjob_id%7D/results/get) endpoint for 30 days. - [Sustainability Insights](https://help.regrow.ag/sustainability-insights?hsLang=en#main-content) - [General](https://help.regrow.ag/sustainability-insights?hsLang=en#general) - [Configure](https://help.regrow.ag/sustainability-insights?hsLang=en#configure) - [Report](https://help.regrow.ag/sustainability-insights?hsLang=en#report) - [Plan](https://help.regrow.ag/sustainability-insights?hsLang=en#plan) - [Data updates](https://help.regrow.ag/sustainability-insights?hsLang=en#data-updates) - [Models](https://help.regrow.ag/sustainability-insights?hsLang=en#models) - [Integrations](https://help.regrow.ag/sustainability-insights?hsLang=en#integrations) - [MRV](https://help.regrow.ag/mrv?hsLang=en#main-content) - [Login and registration](https://help.regrow.ag/mrv?hsLang=en#login-and-registration) - [Field boundaries](https://help.regrow.ag/mrv?hsLang=en#field-boundaries) - [Data entry tips and guidelines](https://help.regrow.ag/mrv?hsLang=en#data-entry-tips-and-guidelines) - [Data entry accelerators](https://help.regrow.ag/mrv?hsLang=en#data-entry-accelerators) - [Soil sampling](https://help.regrow.ag/mrv?hsLang=en#soil-sampling) - [Program data review](https://help.regrow.ag/mrv?hsLang=en#program-data-review) - [Reporting](https://help.regrow.ag/mrv?hsLang=en#reporting) - [Research and data credits](https://help.regrow.ag/research-and-data-credits?hsLang=en) - [Measure API: Enteric](https://help.regrow.ag/measure-api-enteric?hsLang=en#main-content) - [Getting started](https://help.regrow.ag/measure-api-enteric?hsLang=en#getting-started) - [Measure API: Intervention](https://help.regrow.ag/measure-api-intervention?hsLang=en#main-content) - [Introduction](https://help.regrow.ag/measure-api-intervention?hsLang=en#introduction) - [Getting started](https://help.regrow.ag/measure-api-intervention?hsLang=en#getting-started) - [Common Questions](https://help.regrow.ag/measure-api-intervention?hsLang=en#common-questions) - [Outcomes](https://help.regrow.ag/measure-api-intervention?hsLang=en#outcomes) - [Product Releases](https://help.regrow.ag/measure-api-intervention?hsLang=en#product-releases) - [Measure API: Inventory](https://help.regrow.ag/measure-api-inventory?hsLang=en#main-content) - [Introduction](https://help.regrow.ag/measure-api-inventory?hsLang=en#introduction) - [Getting started](https://help.regrow.ag/measure-api-inventory?hsLang=en#getting-started) - [Outcomes](https://help.regrow.ag/measure-api-inventory?hsLang=en#outcomes) - [Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#main-content) - [Getting started](https://help.regrow.ag/monitor-api?hsLang=en#getting-started) - [Remote sensing technology](https://help.regrow.ag/monitor-api?hsLang=en#remote-sensing-technology) - [Integrate with Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#integrate-with-monitor-api) - [Understanding Monitor field data](https://help.regrow.ag/monitor-api?hsLang=en#understanding-monitor-field-data) - [Cradle to farm-gate emission factors](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#main-content) - [Getting started](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#getting-started) - [Methodology](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#methodology) - [On-field activity data sources](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#on-field-activity-data-sources) [![Chill listening crop-3](https://help.regrow.ag/hs-fs/hubfs/03.%20Logos/Regrow_logo.png?width=96&height=24&name=Regrow_logo.png "Chill listening crop-3")](https://www.regrow.ag/) Copyright © 2026, Regrow Agriculture Inc. ```json { "@context" : "https://schema.org", "@type" : "VideoObject", "caption" : { "@type" : "MediaObject", "contentUrl" : "https://help.regrow.ag/media-transcripts/195292540678/en.vtt", "inLanguage" : "en", "name" : "en Captions" }, "contentUrl" : "https://stream.mux.com/Ep9riq02xsNVcXo48ezWSyJF78V9HUypTWbEpPB3pnkg/capped-1080p.mp4", "dateModified" : "2025-08-29T16:00:26.366Z", "duration" : "PT6M11S", "height" : 1800, "name" : "Monitor API Integration guide", "thumbnailUrl" : "https://4430549.fs1.hubspotusercontent-na1.net/hubfs/4430549/Monitor%20API%20Integration%20guide.mov/medium.jpg", "uploadDate" : "2025-08-29T15:59:52.598Z", "width" : 2880 } ```