Batches
The batches endpoint returns scan results for your organisation. Each batch represents a tray scan session, including germination rates, seedling counts, and a link to the full analysis.
v1 — Flat list
Returns all matching batches as a flat JSON array.
Endpoint: GET /v1/batches
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date |
string (ISO 8601, UTC) |
No | Return batches on or after this date |
end_date |
string (ISO 8601, UTC) |
No | Return batches on or before this date |
Sample usage
# All batches
curl https://portal-api.visiontrack.nl/v1/batches \
-H "Authorization: Bearer ACCESS_TOKEN"
# Filtered by date range
curl "https://portal-api.visiontrack.nl/v1/batches?start_date=2025-01-01T00:00:00Z&end_date=2025-06-01T00:00:00Z" \
-H "Authorization: Bearer ACCESS_TOKEN"
import httpx
headers = {"Authorization": "Bearer ACCESS_TOKEN"}
resp = httpx.get(
"https://portal-api.visiontrack.nl/v1/batches",
headers=headers,
params={
"start_date": "2025-01-01T00:00:00Z",
"end_date": "2025-06-01T00:00:00Z",
},
)
resp.raise_for_status()
batches = resp.json()
Response
A JSON array of batch objects.
[
{
"batch_id": "133b975c-8397-43e4-bb5a-e699f7b4b492",
"batch_name": "batch_abc789",
"batch_creation_date": "2025-05-20T16:22:10.123456+02:00",
"crop_type": "Lettuce",
"number_of_images": 200,
"total_cells_per_tray": 128,
"avg_germinated_seedlings": "110.50",
"avg_non_germinated_seedlings": "12.00",
"avg_germination_rate": "90.15",
"avg_usable_seedlings": "105.75",
"avg_non_usable_cells": "5.75",
"avg_usable_seedling_rate": "85.33",
"avg_coefficient_of_variation": "30.05",
"avg_median_seedling_size_mm2": "383.18",
"scanned_by_email": "user@example.com",
"analysis_link": "https://portal.example.com/analysis/batch_abc789",
"comment": null,
"warnings": false
}
]
v2 — Paginated
Returns batches in pages. Each response includes a next_token field — if present, pass it in the next request to retrieve the following page.
Endpoint: GET /v2/batches
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date |
string (ISO 8601, UTC) |
No | Return batches on or after this date |
end_date |
string (ISO 8601, UTC) |
No | Return batches on or before this date |
next_token |
string |
No | Pagination cursor from the previous response |
Sample usage
# First page
curl https://portal-api.visiontrack.nl/v2/batches \
-H "Authorization: Bearer ACCESS_TOKEN"
# Next page
curl "https://portal-api.visiontrack.nl/v2/batches?next_token=NEXT_TOKEN" \
-H "Authorization: Bearer ACCESS_TOKEN"
import httpx
headers = {"Authorization": "Bearer ACCESS_TOKEN"}
next_token = None
while True:
params = {}
if next_token:
params["next_token"] = next_token
resp = httpx.get("https://portal-api.visiontrack.nl/v2/batches", headers=headers, params=params)
resp.raise_for_status()
body = resp.json()
for batch in body["data"]:
print(batch["batch_name"], batch["avg_germination_rate"])
next_token = body.get("next_token")
if not next_token:
break
Response
{
"data": [
{
"batch_id": "133b975c-8397-43e4-bb5a-e699f7b4b492",
"batch_name": "batch_abc789",
"batch_creation_date": "2025-05-20T16:22:10.123456+02:00",
"crop_type": "Lettuce",
"number_of_images": 200,
"total_cells_per_tray": 128,
"avg_germinated_seedlings": "110.50",
"avg_non_germinated_seedlings": "12.00",
"avg_germination_rate": "90.15",
"avg_usable_seedlings": "105.75",
"avg_non_usable_cells": "5.75",
"avg_usable_seedling_rate": "85.33",
"avg_coefficient_of_variation": "30.05",
"avg_median_seedling_size_mm2": "383.18",
"scanned_by_email": "user@example.com",
"analysis_link": "https://portal.example.com/analysis/batch_abc789",
"comment": null,
"warnings": false
}
],
"next_token": "MjAyNS0wNC0xMCAxNDoyNTo1Ni4wMDAwMDA"
}
If next_token is null, you have reached the last page.
Response fields
| Field | Type | Description |
|---|---|---|
batch_id |
string |
Unique batch identifier |
batch_name |
string |
Human-readable batch name |
batch_creation_date |
string (ISO 8601) |
When the batch was created, see Date format |
crop_type |
string \| null |
Crop variety scanned |
number_of_images |
integer |
Number of images in the batch |
total_cells_per_tray |
integer \| null |
Cell count per tray |
avg_germinated_seedlings |
decimal \| null |
Average germinated seedlings per tray |
avg_non_germinated_seedlings |
decimal \| null |
Average non-germinated seedlings per tray |
avg_germination_rate |
decimal \| null |
Average germination rate (%) |
avg_usable_seedlings |
decimal \| null |
Average usable seedlings per tray |
avg_non_usable_cells |
decimal \| null |
Average non-usable cells per tray |
avg_usable_seedling_rate |
decimal \| null |
Average usable seedling rate (%) |
avg_coefficient_of_variation |
decimal \| null |
Average coefficient of variation of the seedling size (%) |
avg_median_seedling_size_mm2 |
decimal \| null |
Average median seedling size (mm²) |
scanned_by_email |
string \| null |
Email of the user who ran the scan |
analysis_link |
string \| null |
URL to the full analysis report |
comment |
string \| null |
Optional comment on the batch |
warnings |
boolean |
Whether the batch has any warnings |
Date format
The start_date and end_date query parameters must be in UTC ISO 8601 format, ending with Z.