---
title: "Create a Harvest"
method: POST
path: "/{resource_name}/{resource_id}/harvests"
tags: ["Harvests"]
---

# Create a Harvest

`POST /{resource_name}/{resource_id}/harvests`

Create a harvest record

### Parameters

**qty** `REQUIRED`

A positive numeric value for the amount harvested (in the harvest unit supplied)

* * *

**unit** `REQUIRED`

The unit of the harvest. This should match the parent resource harvest_unit.

* * *

**date** `OPTIONAL`

Date of the harvest, defaults to today

* * *

**batch_number** `OPTIONAL`

An optional string value representing the batch number for the harvest. Useful if grouping multiple harvests into a single batch for future identification.

* * *

**description** `OPTIONAL`

Details or summary about the harvest

* * *

**grade** `OPTIONAL`

An optional string grade for the harvest. For example: Prime, AA, Jumbo, etc.

* * *

**price** `OPTIONAL`

An optional positive numeric value representing the current market value of the harvest. This is used to calculate estimated revenue for the harvest.

* * *

**trace_number** `OPTIONAL`

An optional string to identify the unique harvest information for traceability. If left blank, the system will automatically generate a trace number when creating a new harvest record.

## Path parameters

- `resource_name` string, required
- `resource_id` string, required

## Headers

- `Content-Type` string

## Request body

- object

## Response `200`

Successful response

---

[API](https://skmtc.net/farmbrite/apis/farmbrite-api-developers-documentation.md) · [All operations](https://skmtc.net/farmbrite/apis/farmbrite-api-developers-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/farmbrite/farmbrite-api-developers-documentation/revisions/b33a389fa2c0/schema)