v1

latestOpenAPI 3.0.02026-08-061380344.2 KB
Animals & Livestock > Feedings

Create a Feeding

Create a feeding record

Parameters

amount REQUIRED

Numeric value representing the amount fed in the unit provided or a compatible unit of the inventory type (if supplying an inventory_id)


cost OPTIONAL

Cost of feeding, this will be automatically calculated if supplying an inventory_id


date OPTIONAL

The date of the feeding. Defaults to today - formatted as YYYY-MM-DD


description OPTIONAL

Description of the feeding


type OPTIONAL

Feeding details. For example feed type. Required if not providing inventory id


inventory_id OPTIONAL

The Farmbrite ID for the inventory record to associate with this feeding. If supplied Farmbrite will try to deduct the amount of the feeding from the inventory. Required if not providing feeding type


inventory_location_id OPTIONAL

The location of the inventory to use. This can be found by querying the inventory type inventory, see location_id in response that matches with the location you want to use - eg; warehouse and bin combination. Required when supplying an inventory_id


unit OPTIONAL

The unit of the feeding. If supplying an inventory_id this must be compatible with the inventory units. Support values are:

"Quantity", "Ounces", "Pounds", "Tons", "Grams", "Kilograms", "Tonnes"


per_head OPTIONAL

Boolean value used when creating a feeding for a livestock group. If true will create a duplicate feeding for each animal in the group using the values you provide. If set to false will split the amount evenly across each animal in the group.

Defaults to false

post/{resource_name}/{resource_id}/feedings

Path parameters

resource_namestring required

animals or livestock_groups

resource_idstring required

animal id or livestock group id

Headers

Content-Typestring

Request body

object required

Example request

{
  "amount": 10,
  "cost": 15,
  "date": "2026-07-01",
  "description": "API Feeding",
  "type": "Feeding details (Required if not providing inventory id)",
  "inventory_id": "Inventory ID (Required if not providing type)",
  "inventory_location_id": "Inventory Location ID (Required if not inventory_id)",
  "unit": "pounds",
  "per_head": false
}

Response

Successful response