The /v1/farms/:id/products endpoint returns product data for a specific farm.
GET https://api.bhumifarms.co/v1/farms/:id/products
Tier differences
| Tier | What you get |
|---|
| Free | Array of product name strings from the farm’s profile |
| Paid | Structured product listings with price, unit, category, and stock status |
Parameters
The farm’s unique identifier (UUID).
Example request
curl "https://api.bhumifarms.co/v1/farms/abc123-def456/products" \
-H "X-API-Key: bh_live_your_key_here"
Example response (paid tier)
{
"data": {
"farm_id": "abc123-def456",
"farm_name": "Prairie Farmstead",
"product_count": 3,
"products": [
{
"id": "prod_001",
"name": "Grass-Fed Ground Beef",
"price": 9.50,
"unit": "lb",
"category": "meat",
"in_stock": true
},
{
"id": "prod_002",
"name": "Pastured Eggs",
"price": 7.00,
"unit": "dozen",
"category": "eggs",
"in_stock": true
},
{
"id": "prod_003",
"name": "Beef Tallow",
"price": 12.00,
"unit": "quart",
"category": "value-added",
"in_stock": false
}
]
}
}
Example response (free tier)
{
"data": {
"farm_id": "abc123-def456",
"farm_name": "Prairie Farmstead",
"product_count": 3,
"products": ["grass-fed beef", "pastured eggs", "beef tallow"]
}
}
Response fields
The farm’s unique identifier.
Total number of products listed by this farm.
On the paid tier, an array of structured product objects. On the free tier, an array of product name strings.