{"openapi":"3.1.0","info":{"title":"BRD Groundtruth C API","description":"Read-only REST API for your own farm data — fields, weather, irrigation scheduling, soil health, yield history, equipment, and market prices. Authenticate with a personal API key generated at crops.bishopresearch.com/dashboard/settings.","version":"1.0.0"},"servers":[{"url":"/api/v1"}],"paths":{"/me":{"get":{"summary":"Get the authenticated account","operationId":"v1_me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Me Me Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/fields":{"get":{"summary":"List your fields","operationId":"v1_list_fields_fields_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 List Fields Fields Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/fields/{field_id}":{"get":{"summary":"Get a single field","operationId":"v1_get_field_fields__field_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"field_id","in":"path","required":true,"schema":{"type":"integer","title":"Field Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Get Field Fields  Field Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fields/{field_id}/weather":{"get":{"summary":"Get the weather forecast for a field","operationId":"v1_field_weather_fields__field_id__weather_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"field_id","in":"path","required":true,"schema":{"type":"integer","title":"Field Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Field Weather Fields  Field Id  Weather Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fields/{field_id}/irrigation":{"get":{"summary":"Get the FAO-56 irrigation schedule for a field","operationId":"v1_field_irrigation_fields__field_id__irrigation_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"field_id","in":"path","required":true,"schema":{"type":"integer","title":"Field Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Field Irrigation Fields  Field Id  Irrigation Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/soil-health":{"get":{"summary":"Get cross-field soil health summary","operationId":"v1_soil_health_soil_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Soil Health Soil Health Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/yield-history":{"get":{"summary":"Get yield history from your recorded harvest entries","operationId":"v1_yield_history_yield_history_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Yield History Yield History Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/equipment":{"get":{"summary":"List your logged equipment","operationId":"v1_equipment_equipment_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Equipment Equipment Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/market/prices":{"get":{"summary":"Get current corn/soybean/wheat price estimates","operationId":"v1_market_prices_market_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Market Prices Market Prices Get"}}}}},"security":[{"HTTPBearer":[]}]}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}