{
  "opencollection": "1.0.0",
  "info": {
    "name": "DTN Farm Intelligence API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "client_credentials",
      "accessTokenUrl": "https://api.auth.dtn.com/v1/tokens/authorize",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Producer Search",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Search producers by radius",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producer/search/radius",
            "params": [
              {
                "name": "lat",
                "value": "",
                "type": "query",
                "description": "Latitude of the center point (decimal degrees, WGS84)."
              },
              {
                "name": "lon",
                "value": "",
                "type": "query",
                "description": "Longitude of the center point (decimal degrees, WGS84)."
              },
              {
                "name": "radius",
                "value": "",
                "type": "query",
                "description": "Search radius in meters. Maximum approximately 16,093m (10 miles)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              }
            ]
          },
          "docs": "Find producers whose registered address falls within a radius of a geographic point.\nReturns the full producer record for each match. Results are sorted by proximity.\n\n**Billing:** Metered — 1 credit per producer returned.\n"
        },
        {
          "info": {
            "name": "Find producers within a GeoJSON polygon",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/channels",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Find producers whose registered address falls within a GeoJSON polygon boundary.\nAccepts a GeoJSON Polygon geometry in the request body and returns matching producers.\n\n**Billing:** Metered — 1 credit per producer returned.\n"
        },
        {
          "info": {
            "name": "Match a producer by name/address/contact",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/match",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Match a producer record by providing partial identifying information (name, address,\nphone, or email). Returns the best-matching producer record if found. Useful for\ndeduplication and CRM integration workflows.\n\n**Billing:** Metered — 1 credit per successful match.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Producer Details",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get producer details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/:partyId",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve the full detail record for a single producer by their party ID.\nReturns contact information, address, role, status, and external identifiers.\n\n**Billing:** Metered — 1 credit per request.\n"
        },
        {
          "info": {
            "name": "Get consumer details for a producer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/:partyId/consumer",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve consumer/demographic details for a producer, including age, household\ncomposition, income, education, occupation, and predictive persona classification.\n\n**Billing:** Metered — 1 credit per request.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Producer Relationships",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get land linked to a producer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/:partyId/land",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve the land parcel IDs linked to a producer. Returns a list of land-party\nassociations. Use /land/{landId} to get full metadata for each parcel.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get grain bins for a producer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/:partyId/grainbin",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve grain bin IDs associated with a producer.\n\n**Billing:** Metered — 1 credit per record (linked data scope).\n"
        },
        {
          "info": {
            "name": "Get related parties for a producer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/:partyId/related",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve parties related to a producer (e.g., household members, business partners,\nlandlords). Returns relationship type descriptions mapped from internal codes.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Batch grain bin search by party IDs",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/producers/grainbin/search",
            "params": [
              {
                "name": "party-id",
                "value": "",
                "type": "query",
                "description": "Comma-separated list of producer party IDs."
              }
            ]
          },
          "docs": "Search grain bins for multiple producers in a single request. Accepts a comma-separated\nlist of party IDs and returns all bins associated with those producers.\n\n**Billing:** Metered — 1 credit per record (linked data scope).\n"
        }
      ]
    },
    {
      "info": {
        "name": "Segments",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List all segments",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/segments"
          },
          "docs": "List all segments (saved producer audiences) for the authenticated customer account.\nReturns segment metadata including creator name and producer count.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get producers in a segment",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/segments/:segmentId/producers",
            "params": [
              {
                "name": "segmentId",
                "value": "",
                "type": "path",
                "description": "Unique segment identifier."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              },
              {
                "name": "role",
                "value": "",
                "type": "query",
                "description": "Filter by producer role."
              },
              {
                "name": "status",
                "value": "",
                "type": "query",
                "description": "Filter by relationship status."
              },
              {
                "name": "has-email",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) email addresses."
              },
              {
                "name": "has-phone",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) phone numbers."
              },
              {
                "name": "has-external-id",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) external CRM identifiers."
              },
              {
                "name": "fips-code",
                "value": "",
                "type": "query",
                "description": "Filter to producers in a specific county (5-digit FIPS code)."
              }
            ]
          },
          "docs": "Retrieve producers belonging to a specific segment. Supports pagination and optional\nfilters for role, status, contact availability, and geographic location.\n\n**Billing:** Metered — 1 credit per producer returned.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Portfolios",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List all portfolios",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/portfolios"
          },
          "docs": "List all portfolios (curated producer lists) for the authenticated customer account.\nReturns portfolio metadata including creator name and producer count.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get producers in a portfolio",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/portfolios/:portfolioId/producers",
            "params": [
              {
                "name": "portfolioId",
                "value": "",
                "type": "path",
                "description": "Unique portfolio identifier."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              },
              {
                "name": "role",
                "value": "",
                "type": "query",
                "description": "Filter by producer role."
              },
              {
                "name": "status",
                "value": "",
                "type": "query",
                "description": "Filter by relationship status."
              },
              {
                "name": "has-email",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) email addresses."
              },
              {
                "name": "has-phone",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) phone numbers."
              },
              {
                "name": "has-external-id",
                "value": "",
                "type": "query",
                "description": "Filter to producers with (true) or without (false) external CRM identifiers."
              },
              {
                "name": "fips-code",
                "value": "",
                "type": "query",
                "description": "Filter to producers in a specific county (5-digit FIPS code)."
              }
            ]
          },
          "docs": "Retrieve producers belonging to a specific portfolio. Supports pagination and optional\nfilters for role, status, contact availability, and geographic location.\n\n**Billing:** Metered — 1 credit per producer returned.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Land Search",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Search land parcels",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/search",
            "params": [
              {
                "name": "lat",
                "value": "",
                "type": "query",
                "description": "Latitude of the center point (required for radius mode)."
              },
              {
                "name": "lon",
                "value": "",
                "type": "query",
                "description": "Longitude of the center point (required for radius mode)."
              },
              {
                "name": "radius",
                "value": "",
                "type": "query",
                "description": "Search radius in meters (required for radius mode)."
              },
              {
                "name": "fips-code",
                "value": "",
                "type": "query",
                "description": "5-digit county FIPS code (required for FIPS code mode)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              }
            ]
          },
          "docs": "Search land parcels by geographic criteria. Supports two mutually exclusive modes:\n\n1. **Radius mode** — Provide `lat`, `lon`, and `radius` to find parcels within a circle.\n2. **FIPS code mode** — Provide `fips-code` to find all parcels in a county.\n\nYou must provide either (lat + lon + radius) OR fips-code, not both.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Batch land metadata by IDs",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/list",
            "params": [
              {
                "name": "land-id",
                "value": "",
                "type": "query",
                "description": "Comma-separated list of land parcel IDs."
              }
            ]
          },
          "docs": "Retrieve metadata for multiple land parcels in a single request. Accepts a\ncomma-separated list of land IDs.\n\n**Billing:** Unmetered (discovery class).\n"
        }
      ]
    },
    {
      "info": {
        "name": "Land Details",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get land metadata by ID",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve detailed metadata for a single land parcel, including acreage, coordinates,\nand county name (enriched as \"County, ST\" format with state abbreviation).\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get producers linked to a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId/producers",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve all producers (operators, owners) associated with a specific land parcel.\nReturns producer details including role, crop year, and geographic information.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get grain bins on a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId/grainbin",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve grain storage bins located on a specific land parcel. Returns bin\nlocation, capacity, and the year the data was recorded.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get soil types for a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId/soil",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve soil type classification data for a specific land parcel. Returns\nsoil series, map unit information, and coverage area within the parcel.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get soil intersection data for a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId/soil/intersection",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve detailed soil intersection data for a land parcel. Returns the geometric\nintersection of soil map units with the land boundary, providing precise soil\ncoverage information including NCCPI productivity ratings and drainage characteristics.\n\n**Billing:** Unmetered (discovery class).\n"
        }
      ]
    },
    {
      "info": {
        "name": "Land Crop",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get crop history for a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/land/:landId/crop",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              },
              {
                "name": "year",
                "value": "",
                "type": "query",
                "description": "Filter to a specific crop year."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip (for pagination)."
              }
            ]
          },
          "docs": "Retrieve crop planting and harvest history for a specific land parcel. Optionally\nfilter by year. Results are paginated.\n\n**Billing:** Metered — 1 credit per crop-year record returned.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Land Geospatial",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get GeoJSON polygon for a land parcel",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/geospatial/land/:landId",
            "params": [
              {
                "name": "landId",
                "value": "",
                "type": "path",
                "description": "Unique land parcel identifier."
              }
            ]
          },
          "docs": "Retrieve the GeoJSON FeatureCollection representing the boundary polygon(s) for a\nland parcel. Properties include land metadata such as acreage, FIPS code, and\ncrop/name status flags.\n\n**Billing:** Unmetered (discovery class).\n"
        },
        {
          "info": {
            "name": "Get GeoJSON polygons for a producer's lands",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/geospatial/producers/:partyId",
            "params": [
              {
                "name": "partyId",
                "value": "",
                "type": "path",
                "description": "Unique producer identifier."
              }
            ]
          },
          "docs": "Retrieve a GeoJSON FeatureCollection containing boundary polygons for all land\nparcels linked to a producer. Properties include the land-party relationship details\nsuch as role, crop type, and acreage.\n\n**Billing:** Unmetered (discovery class).\n"
        }
      ]
    },
    {
      "info": {
        "name": "Codes",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List all crop codes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/codes/crops"
          },
          "docs": "Retrieve the full list of crop codes from the Land Cover Index (LCI). Use the\n`cropId` (LCI ID) when filtering other endpoints by crop type.\n\n**Billing:** Unmetered.\n"
        },
        {
          "info": {
            "name": "Get a single crop code",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/codes/crops/:lciId",
            "params": [
              {
                "name": "lciId",
                "value": "",
                "type": "path",
                "description": "Land Cover Index (crop type) identifier."
              }
            ]
          },
          "docs": "Retrieve a single crop code by its LCI ID. Returns the crop name and identifier.\n\n**Billing:** Unmetered.\n"
        },
        {
          "info": {
            "name": "Get credit balance",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/credits"
          },
          "docs": "Retrieve the current credit balance and contract end date for the authenticated customer.\nShows the quota pool limit, remaining credits, and when the contract period ends.\n\n**Billing:** Unmetered.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Geographic Areas",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List all US counties",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/geographic-areas/counties"
          },
          "docs": "Retrieve the full list of US counties with their FIPS codes and state associations.\nUse `fipsCode` values when filtering producer endpoints by county.\n\n**Billing:** Unmetered.\n"
        },
        {
          "info": {
            "name": "List all US states",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api-farm-intelligence.dev.ag.zones.dtn.com/api/v1/geographic-areas/states"
          },
          "docs": "Retrieve the full list of US states with their two-letter codes.\n\n**Billing:** Unmetered.\n"
        }
      ]
    }
  ],
  "bundled": true
}