get_farm

Get a complete farm profile by ID — products with pricing, story, certifications, practices, contact info, hours, images, and quality scores.

Parameters

Example request

curl "https://api.bhumifarms.co/v1/farms/f8a1c2d3-4e5f-6789-abcd-ef0123456789" \
  -H "X-API-Key: bh_live_your_key"

Example response

{
  "id": "f8a1c2d3-4e5f-6789-abcd-ef0123456789",
  "name": "Headwater Hills Creamery",
  "city": "McMinnville",
  "state": "OR",
  "quality_tier": "Premium",
  "description": "Third-generation family dairy producing raw milk and artisan cheeses from our herd of grass-fed Jersey cows.",
  "story": "We started in 1987 with six cows and a dream...",
  "certifications": ["Certified Organic", "Animal Welfare Approved"],
  "practices": ["grass-fed", "pasture-raised", "no antibiotics", "rotational grazing"],
  "contact": {
    "phone": "(503) 555-0142",
    "email": "info@headwaterhills.com",
    "website": "https://headwaterhills.com"
  },
  "hours": {
    "farm_store": "Tue–Sat 9am–5pm",
    "pickup": "Fri 2pm–6pm"
  },
  "images": [
    "https://cdn.bhumifarms.co/farms/f8a1c2d3/hero.jpg",
    "https://cdn.bhumifarms.co/farms/f8a1c2d3/cows.jpg"
  ],
  "product_listings": [
    {
      "name": "Raw Cow Milk",
      "price": 12.00,
      "unit": "gallon",
      "in_stock": true,
      "category": "raw dairy"
    },
    {
      "name": "Farmstead Cheddar",
      "price": 9.50,
      "unit": "8 oz block",
      "in_stock": true,
      "category": "cheese"
    },
    {
      "name": "Pastured Eggs",
      "price": 6.00,
      "unit": "dozen",
      "in_stock": false,
      "category": "eggs"
    }
  ],
  "quality_scores": {
    "listing_completeness": 0.94,
    "verification_level": "verified",
    "last_updated": "2026-03-28"
  }
}