Record a harvest area

curl --request POST \
  --url https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
  "grower_contact_email": "grower@example.com",
  "grower_contact_name": "Jane Doe",
  "latitude": 44.0521,
  "longitude": -123.0868,
  "name": "North Block (Demo)"
}
'

import requests

url = "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas"

payload = {
    "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
    "grower_contact_email": "grower@example.com",
    "grower_contact_name": "Jane Doe",
    "latitude": 44.0521,
    "longitude": -123.0868,
    "name": "North Block (Demo)"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    farm_location_id: 'Rj4PkW7mXn3VcBz9Ta2SgH',
    grower_contact_email: 'grower@example.com',
    grower_contact_name: 'Jane Doe',
    latitude: 44.0521,
    longitude: -123.0868,
    name: 'North Block (Demo)'
  })
};

fetch('https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'farm_location_id' => 'Rj4PkW7mXn3VcBz9Ta2SgH',
    'grower_contact_email' => 'grower@example.com',
    'grower_contact_name' => 'Jane Doe',
    'latitude' => 44.0521,
    'longitude' => -123.0868,
    'name' => 'North Block (Demo)'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas"

	payload := strings.NewReader("{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}"

response = http.request(request)
puts response.read_body

{
  "business_name_override": "",
  "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
  "grower_contact_email": "grower@example.com",
  "grower_contact_name": "Jane Doe",
  "grower_contact_phone": "+15035550123",
  "id": "Hb6TnQ9sZc2LwYx4Mk8VdE",
  "latitude": 44.0521,
  "longitude": -123.0868,
  "name": "North Block (Demo)"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

POST

compliance

api

organizations

{organization_id}

harvest-areas

Record a harvest area

curl --request POST \
  --url https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
  "grower_contact_email": "grower@example.com",
  "grower_contact_name": "Jane Doe",
  "latitude": 44.0521,
  "longitude": -123.0868,
  "name": "North Block (Demo)"
}
'

import requests

url = "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas"

payload = {
    "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
    "grower_contact_email": "grower@example.com",
    "grower_contact_name": "Jane Doe",
    "latitude": 44.0521,
    "longitude": -123.0868,
    "name": "North Block (Demo)"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    farm_location_id: 'Rj4PkW7mXn3VcBz9Ta2SgH',
    grower_contact_email: 'grower@example.com',
    grower_contact_name: 'Jane Doe',
    latitude: 44.0521,
    longitude: -123.0868,
    name: 'North Block (Demo)'
  })
};

fetch('https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'farm_location_id' => 'Rj4PkW7mXn3VcBz9Ta2SgH',
    'grower_contact_email' => 'grower@example.com',
    'grower_contact_name' => 'Jane Doe',
    'latitude' => 44.0521,
    'longitude' => -123.0868,
    'name' => 'North Block (Demo)'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas"

	payload := strings.NewReader("{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/compliance/api/v1/organizations/{organization_id}/harvest-areas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"farm_location_id\": \"Rj4PkW7mXn3VcBz9Ta2SgH\",\n  \"grower_contact_email\": \"grower@example.com\",\n  \"grower_contact_name\": \"Jane Doe\",\n  \"latitude\": 44.0521,\n  \"longitude\": -123.0868,\n  \"name\": \"North Block (Demo)\"\n}"

response = http.request(request)
puts response.read_body

{
  "business_name_override": "",
  "farm_location_id": "Rj4PkW7mXn3VcBz9Ta2SgH",
  "grower_contact_email": "grower@example.com",
  "grower_contact_name": "Jane Doe",
  "grower_contact_phone": "+15035550123",
  "id": "Hb6TnQ9sZc2LwYx4Mk8VdE",
  "latitude": 44.0521,
  "longitude": -123.0868,
  "name": "North Block (Demo)"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

{
  "detail": "The requested resource was not found.",
  "error_code": "not_found",
  "retryable": false,
  "status": 404,
  "timestamp": "2026-03-31T12:00:00+00:00",
  "title": "Not Found",
  "type": "https://closient.com/docs/errors/not_found"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

organization_id

string<shortuuid>

required

Identifier of the organization.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Body

application/json

The harvest area to record. An update replaces every field, so send them all.

farm_location_id

string<shortuuid>

required

Identifier of one of the organization's locations: the farm this area belongs to.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

name

string

required

Name of the area within the farm, unique per farm, up to 255 characters.

Required string length: 1 - 255

Pattern: ^[^\x00]{1,255}$

latitude

number | null

Latitude of a single coordinate, -90 to 90. Send with longitude; ignored when wkt is sent.

Required range: -90 <= x <= 90

longitude

number | null

Longitude of a single coordinate, -180 to 180. Send with latitude.

Required range: -180 <= x <= 180

wkt

string | null

Polygon or multipolygon footprint as WGS84 WKT. When sent it is stored instead of the coordinate. At least one of wkt or latitude with longitude is required.

Maximum string length: 100000

Pattern: ^[^\x00]{0,}$

grower_contact_name

string

default:""

On-the-ground contact for the area, up to 255 characters.

Maximum string length: 255

Pattern: ^[^\x00]{0,255}$

grower_contact_phone

string

default:""

Phone of the grower contact, in international format such as +15035550123; empty clears it.

Maximum string length: 40

Pattern: ^[^\x00]{0,40}$

grower_contact_email

string

default:""

Email of the grower contact, up to 254 characters; empty clears it.

Maximum string length: 254

Pattern: ^[^\x00]{0,254}$

business_name_override

string

default:""

Business name of a contract harvester working the farm, up to 255 characters.

Maximum string length: 255

Pattern: ^[^\x00]{0,255}$

Response

Created

One harvest area of a farm location (21 CFR § 1.1320.18).

string<shortuuid>

required

Identifier of the harvest area.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

farm_location_id

string<shortuuid>

required

Identifier of the farm location the area belongs to.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

name

string

required

Name of the area within the farm, such as Field 7B.

latitude

number | null

required

Latitude of the single coordinate; null when only a polygon is on file.

longitude

number | null

required

Longitude of the single coordinate; null when only a polygon is on file.

wkt

string | null

required

The polygon footprint as WGS84 WKT; null when only a coordinate is on file.

grower_contact_name

string

required

On-the-ground contact for the area; empty when not set.

grower_contact_phone

string

required

Phone of the grower contact in E.164; empty when not set.

grower_contact_email

string

required

Email of the grower contact; empty when not set.

business_name_override

string

required

Business name of a contract harvester working the farm; empty means the farm operator's name.

Overview

Account

Products

Brands

Locations

Retailers

Search

GS1 Digital Link

EPCIS 2.0

Integrations

Billing

Scanner

Compliance

Certifications

Sustainability

Notifications

Dashboard

Analytics

Agent

Substances

BYOS

Content

Signals

Record a harvest area

Authorizations

Path Parameters

Body

Response