Bin Scan

Recommended patterns for fetching TrueFruit bin scan data

How to fetch binscan size and grade distributions per orchard

First pull per orchard size measurement dates for a given time period using the farming/truefruit/binscan/measurements/ endpoint. The response will return a list of objects containing an orchard_id and measurement_date. Filter the response using the processed_date query parameter. Using the processed_date is the most robust approach as it will avoid missing records where there was a delay between when the data was collected and when it become available to consume. If you are fetching data on a cron, for example once a day, you will use the date you last fetched data on.
To fetch the detailed orchard distributions and aggregated metrics, pass the orchard_id and measurement_date received in the farming/truefruit/binscan/measurements/ response into the farming/truefruit/binscan/measurements/{orchard_id}/{measurement_date} endpoint. This will return a size, colour and blemish distribution array which contains the histogram bucket ranges and the percentage of fruit which fall in each bucket.

How to fetch binscan size and grade distributions per intake

First pull per orchard size measurement dates for a given time period using the farming/truefruit/binscan/measurements/ endpoint. The response will return a list of objects containing an orchard_id and measurement_date. Filter the response using the processed_date query parameter. Using the processed_date is the most robust approach as it will avoid missing records where there was a delay between when the data was collected and when it become available to consume. If you are fetching data on a cron, for example once a day, you will use the date you last fetched data on.
To fetch the detailed intake distributions and aggregated metrics, pass the orchard_id and measurement_date received in the farming/truefruit/binscan/measurements/ response into the farming/truefruit/binscan/measurements/{orchard_id}/{measurement_date} endpoint. Set the granularity query param to bin_group. The response will include a bin_distributions array. Use this field to access Binscan data aggregated by intake number. The associated intake number is returned in the bin_group_id field.

Bin Scan Measurement Compact

Key	Type	Description
`farm_id`	integer	The unique identifier of the farm , provided by Aerobotics, which the measurement belongs to.
`orchard_id`	integer	The unique identifier of the orchard, provided by Aerobotics, which the measurement belongs to.
`measurement_date`	date	The date that the bin images were captured by the user
`processed_date`	date	The date that the measurement data completed processing by Aerobotics
`average_fruit_size_mm`	number	The average fruit size

Example response

{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    {
      "farm_id": 0,
      "orchard_id": 0,
      "measurement_date": "2025-09-18",
      "processed_date": "2025-09-18",
      "average_fruit_size_mm": 0
    }
  ]
}

Bin Scan Measurement Detailed

Key	Type	Description
`farm_id`	integer	The unique identifier of the farm, provided by Aerobotics, which the measurement belongs to.
`orchard_id`	integer	The unique identifier of the orchard, provided by Aerobotics, which the measurement belongs to.
`measurement_date`	date	The date that the bin images were captured by the user
`processed_date`	date	The date that the measurement data completed processing by Aerobotics
`bin_id`	integer	The unique identifier of the bin, provided by Aerobotics, which the measurement belongs to. Returned when the request param `granularity` is set to `bin`
`bin_external_id`	string	The unique identifier of the bin, provided by user, which the measurement belongs to. Most often inputted by scanning a barcode on the bin using the Aerobotics mobile app.
`bin_group_id`	string	The unique identifier of a bin intake, provided by user, which the measurement belongs to. This data is captured via the Aerobotics mobile app and used to link multiple bins to a shipment
`size_distribution[]`	[object]	An array of distribution objects that can be used to build a histogram of fruit sizes
`blemish_distribution[]`	[object]	An array of distribution objects that can be used to build a histogram of blemish severity
`color_distribution[]`	[object]	An array of distribution objects that can be used to build a histogram of fruit color categories
`average_fruit_size_mm`	number	The average fruit size
`count_fruit_measured`	integer	The number of individual fruit measured
`count_bins`	integer	The number of bins measured
`bin_distributions[]`	[object]	An array of objects containing size, blemish and color distributions per bin. Will be returned when the request param `granularity` is set to `bin_group` or `bin`

Recipes

How do I fetch BinScan Grade distributions per orchard shipment / intake

Open Recipe