canonical: https://jentic.com/apis/farmbrite.com/farmbrite # Farmbrite API The Farmbrite API exposes the farm-management platform's records for animals, livestock groups, feedings, grazings, measurements, and climate gauges. It lets agents and integrations log day-to-day farm activity, retrieve animal histories, and pull environmental readings for reporting or analytics. The 24-endpoint surface is structured around a small number of primary resources with nested activity logs. ## For AI agents Record and retrieve animal records, feedings, grazings, measurements, livestock groups, and climate-gauge readings on a Farmbrite farm. ## Scope Does not handle crop records, field mapping, or accounting - use for animal, grazing, and climate-gauge tracking only. ## Capabilities - Track individual animals with creation, update, and deletion of animal records via /animals - Log feedings against a specific animal and pull historical feeding records via /animals/{animal_id}/feedings - Record physical measurements (weight, body condition) for any animal via /animals/{animal_id}/measurements - Retrieve grazing and livestock-group rosters to plan rotational grazing schedules - Capture climate-gauge readings such as rainfall and temperature to feed weather-aware farm dashboards - Pull animal set-log history to audit treatments, moves, and group assignments ## Use cases ### Daily Farm Activity Logging Smallholder and ranch operations use Farmbrite to log feedings, measurements, and treatments against individual animals each day. The nested /animals/{animal_id}/feedings and /animals/{animal_id}/measurements endpoints make it straightforward to attribute every activity to the correct animal. Replaces paper logs and spreadsheets with a queryable record set in a few hours of integration work. Example prompt: Create a feeding record for animal_id 4521 with feed type, quantity, and timestamp via POST /animals/{animal_id}/feedings ### Livestock Weight and Health Tracking Producers tracking animal performance pull measurement histories from /animals/{animal_id}/measurements to chart weight gain, body condition, and health markers over time. The data feeds breeding decisions, sale-weight forecasts, and veterinary reviews. Pairs well with reporting tools that want a structured feed instead of CSV exports. Example prompt: Pull every measurement for animal_id 4521 via GET /animals/{animal_id}/measurements and chart weight against date ### Climate-Aware Grazing Planning Rotational grazing operations combine /climate_gauges readings with /grazings and /livestock_groups data to plan paddock moves around rainfall and temperature. The API gives planners a programmatic feed instead of polling the Farmbrite UI. Useful for regenerative agriculture dashboards and farm advisory services. Example prompt: Fetch the latest reading from each /climate_gauges entry and cross-reference it with active /grazings to recommend the next paddock move ### AI Farm Assistant via Jentic Conversational farm assistants use Jentic to call Farmbrite operations from natural-language prompts like 'log today's feeding for cow 12'. Jentic resolves the intent to the right /animals/{animal_id}/feedings call and supplies the bearer token from its vault. The agent never handles raw credentials and the operator does not have to integrate the spec directly. Example prompt: Through Jentic, search 'log a feeding for a farm animal', load the operation, and execute with animal_id, feed type, and quantity from the user's voice input ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | /animals | Create a new animal record | | GET | /animals/{animal_id} | Retrieve a single animal | | POST | /animals/{animal_id}/feedings | Log a feeding for an animal | | POST | /animals/{animal_id}/measurements | Record a measurement for an animal | | GET | /grazings | List grazing records | | GET | /livestock_groups | List livestock groups | | POST | /climate_gauges | Create a climate gauge | ## Key resources - **Animals** — Create, retrieve, update, and delete individual animal records - **Feedings** — Log and retrieve feeding events tied to a specific animal - **Measurements** — Capture weight, body condition, and other physical readings per animal - **Grazings** — Read grazing records and rotation history - **Livestock Groups** — Retrieve livestock group rosters used for grazing and treatment - **Climate Gauges** — Manage and read environmental gauges (rainfall, temperature) ## Why Jentic - **Setup:** Wiring the Farmbrite API by hand means handling its bearer auth and threading the animal id through nested feeding and measurement paths yourself. Through Jentic you install once, import Farmbrite from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Farmbrite puts the animal id in the URL path (/animals/{animal_id}/feedings and /animals/{animal_id}/measurements), so a rule can pin your agent to one animal record. You choose the operations it may call, so logging a feeding or a measurement is included only when you add it, while grazing and livestock-group reads can stay read-only. - **Credential handling:** Your Farmbrite bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'log a feeding for an animal', and Jentic returns the nested /animals/{animal_id}/feedings operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **API Ninjas City** — Pull weather and animal reference data to enrich Farmbrite records - **Airtable** — Generic record store - used by farms that built their own schema instead of using Farmbrite - **Smartsheet** — Spreadsheet-style alternative for ad-hoc farm record keeping ## FAQ ### What authentication does the Farmbrite API use? Farmbrite uses HTTP Bearer token authentication - supply your API token in the Authorization header. Through Jentic, the bearer token lives in the vault and is injected at execution time, so the agent never sees the raw token. ### Can I log feedings and measurements for individual animals with the Farmbrite API? Yes. POST to /animals/{animal_id}/feedings to log a feeding event and POST to /animals/{animal_id}/measurements to record weight or body condition. Both endpoints attribute the entry to a specific animal_id. ### What are the rate limits for the Farmbrite API? Farmbrite does not publish explicit rate limits in the OpenAPI spec. Treat it as a low-frequency operational API, batch reads where possible, and respect any 429 responses by backing off. ### How do I retrieve climate gauge readings through Jentic? Install with pip install jentic, search 'list climate gauges on a farm', load the GET /climate_gauges operation, and execute with your Farmbrite bearer token. Get started with Jentic One, the self-hosted execution layer. ### Does the Farmbrite API support crop and field records? The current OpenAPI surface covers animals, feedings, grazings, measurements, livestock groups, and climate gauges. Crop, field, and accounting endpoints are not exposed in this spec - use the Farmbrite UI for those workflows. ### Can I limit what my agent is allowed to do with the Farmbrite API? Yes. Farmbrite is self-hosted through your own Jentic One instance, and your own rules decide which operations and credentials the agent may use. Because Farmbrite puts the animal id in the URL path (/animals/{animal_id}/feedings and /animals/{animal_id}/measurements), you can pin the agent to a single animal record and only include write operations like logging a feeding or a measurement when you add them. You can keep grazing and livestock-group reads read-only, and the agent can call nothing you have not granted.