{"openapi":"3.1.0","info":{"title":"Livestock Market Prices public API","version":"1.3.0-alpha.1","description":"Read reviewed, rights-approved livestock observations from one coherent dataset release, with exact decimal strings and source citations. Reuse requires preserving the original source name and exact link and prohibits presenting source observations or LMP-derived results as the user's own original data.","termsOfService":"https://livestockmarketprices.com/terms#terms-sources"},"externalDocs":{"description":"Citation and source-preservation guidance","url":"https://livestockmarketprices.com/citations"},"servers":[{"url":"https://livestockmarketprices.com"}],"paths":{"/api/v1/benchmarks/usda-cattle":{"get":{"operationId":"getUsdaCattleBenchmark","summary":"Get the separate USDA Texas statewide weekly cattle reference","description":"A source-linked immutable benchmark revision, not an auction venue or a San Angelo cattle reference. Original source units and reporting periods are preserved. The reference is not pooled with auction observations.","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Reviewed reference, or null when unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"schema_version":{"type":"string","const":"usda-1955-facts-v1"},"id":{"type":"string","pattern":"^usda-1955:[a-f0-9]{64}$"},"source":{"type":"string","const":"USDA AMS · Texas Weekly Cattle Auction Summary"},"source_url":{"type":"string","const":"https://mymarketnews.ams.usda.gov/viewReport/1955"},"state":{"type":"string","const":"TX"},"period_begin":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"published_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"artifact_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"report_status":{"type":"string","enum":["Final","Corrected"]},"facts":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"row":{"type":"integer","minimum":0,"maximum":9007199254740991},"classification":{"type":"object","properties":{"category_key":{"type":"string","minLength":1},"class_code":{"type":"string","enum":["unclassified_goats","unclassified_sheep","kids","nannies_does","bucks_billies","wethers_muttons","lambs","ewes","rams_bucks","steers","heifers","cows","bulls","calves","cow_calf_pairs","other_cattle"]},"purpose_code":{"type":"string","enum":["slaughter","replacement","stocker","feeder","show","breeding","unknown"]},"breed_type_code":{"type":"string","enum":["meat_goat","dairy_miniature","angora","hair_sheep","wool_sheep","beef_cattle","dairy_cattle","crossbred_cattle","not_reported"]},"sex_code":{"type":"string","minLength":1,"pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"},"life_stage_code":{"type":"string","minLength":1,"pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"},"quality_grade_code":{"type":"string","minLength":1,"pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"}},"required":["category_key","class_code","purpose_code","breed_type_code","sex_code","life_stage_code","quality_grade_code"],"additionalProperties":false},"raw_class":{"type":"string","minLength":1,"maxLength":300},"qualifiers":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":300}},"weight":{"type":"object","properties":{"lower":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"upper":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"lower_inclusive":{"type":["boolean","null"]},"upper_inclusive":{"type":["boolean","null"]},"reported_average":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string","const":"lb"},{"type":"null"}]}},"required":["lower","upper","lower_inclusive","upper_inclusive","reported_average","unit"],"additionalProperties":false},"quote":{"type":"object","properties":{"type":{"type":"string","enum":["reported_range","reported_average","reported_weighted_average","publisher_top_of_market_range"]},"low":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"high":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"reported_average":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"reported_weighted_average":{"anyOf":[{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},{"type":"null"}]},"currency":{"type":"string","const":"USD"},"unit":{"type":"string","enum":["USD_PER_CWT","USD_PER_LB","USD_PER_HEAD","USD_PER_PAIR"]},"measurement_basis":{"type":"string","enum":["liveweight","other"]}},"required":["type","low","high","reported_average","reported_weighted_average","currency","unit","measurement_basis"],"additionalProperties":false},"head_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["row","classification","raw_class","qualifiers","weight","quote","head_count"],"additionalProperties":false}}},"required":["schema_version","id","source","source_url","state","period_begin","period_end","published_at","retrieved_at","artifact_sha256","report_status","facts"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/healthz":{"get":{"operationId":"getHealth","summary":"Check whether a coherent published release is readable","responses":{"200":{"description":"Public read path is ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/prices":{"get":{"operationId":"listPrices","summary":"List reviewed public price observations","parameters":[{"name":"species","in":"query","schema":{"type":"string","enum":["goat","sheep","cattle"]}},{"name":"class","in":"query","schema":{"type":"string","enum":["unclassified_goats","unclassified_sheep","kids","nannies_does","bucks_billies","wethers_muttons","lambs","ewes","rams_bucks","steers","heifers","cows","bulls","calves","cow_calf_pairs","other_cattle"]}},{"name":"purpose","in":"query","schema":{"type":"string","enum":["slaughter","replacement","stocker","feeder","show","breeding"]}},{"name":"breed_type","in":"query","schema":{"type":"string","enum":["meat_goat","dairy_miniature","angora","hair_sheep","wool_sheep","beef_cattle","dairy_cattle","crossbred_cattle"]}},{"name":"weight_band","in":"query","schema":{"type":"string","enum":["unreported","20-39","40-59","60-79","80-109","110-plus","under-300","300-399","400-499","500-599","600-699","700-799","800-999","1000-plus"]}},{"name":"location","in":"query","description":"Namespaced published location selector: all, state:CC:AA, region:ID, or market:ID","schema":{"type":"string","pattern":"^(?:all|state:[A-Z]{2}:[A-Z0-9]{2,3}|region:[A-Za-z0-9][A-Za-z0-9._:-]{0,127}|market:[A-Za-z0-9][A-Za-z0-9._:-]{0,127})$"}},{"name":"weight_lb","in":"query","description":"Exact positive decimal pounds, at most 5000","schema":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,3})(?:\\.\\d{1,9})?$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"Published observations","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricesResponse"}}}},"304":{"description":"The supplied ETag still matches"},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"No published observations match the valid filters (NO_MATCHING_PRICES)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoMatchingPricesError"}}}},"409":{"description":"The cursor belongs to a different dataset release (STALE_CURSOR)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StaleCursorError"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/reports/{report_id}":{"get":{"operationId":"getReport","summary":"Get one current published report revision","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"Published report","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"304":{"description":"The supplied ETag still matches"},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/coverage":{"get":{"operationId":"getCoverage","summary":"Describe actual published market, species, and date coverage","responses":{"200":{"description":"Published coverage","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageResponse"}}}},"304":{"description":"The supplied ETag still matches"},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/methodologies":{"get":{"operationId":"listMethodologies","summary":"List active public methodology definitions","responses":{"200":{"description":"Active methodologies","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MethodologiesResponse"}}}},"304":{"description":"The supplied ETag still matches"},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/methodologies/{version}":{"get":{"operationId":"getMethodology","summary":"Get an active public methodology by version","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"Active methodology","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MethodologiesResponse"}}}},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/valuations":{"post":{"operationId":"estimateValuation","summary":"Calculate a Member account's gross-value estimate","description":"Uses one eligible USD-per-CWT liveweight observation for a signed-in Member or Pro account. Per-head and per-pair quotes remain public but are rejected for stateless valuation because they cannot be converted truthfully. Herd inputs are not persisted by this endpoint.","security":[{"memberSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValuationRequest"}}}},"responses":{"200":{"description":"Modeled gross value","headers":{"Cache-Control":{"description":"Anonymous valuation inputs and results are not cached","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValuationResponse"}}}},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"408":{"description":"The request body missed the total read deadline (REQUEST_BODY_TIMEOUT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestBodyTimeoutError"}}}},"413":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"The member valuation rate boundary rejected the request (VALUATION_RATE_LIMITED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValuationRateLimitedError"}}}},"503":{"description":"The data service or production member-valuation rate boundary is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValuationUnavailableError"}}}}}}},"/api/v1/openapi.json":{"get":{"operationId":"getOpenApi","summary":"Download this OpenAPI 3.1 contract","responses":{"200":{"description":"OpenAPI document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/data/prices.csv":{"get":{"operationId":"downloadPricesCsv","summary":"Download the same filtered observations as formula-safe CSV","parameters":[{"$ref":"#/components/parameters/Species"},{"$ref":"#/components/parameters/Class"},{"$ref":"#/components/parameters/Purpose"},{"$ref":"#/components/parameters/BreedType"},{"$ref":"#/components/parameters/WeightBand"},{"$ref":"#/components/parameters/Location"},{"$ref":"#/components/parameters/WeightLb"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"UTF-8 CSV with provenance columns","headers":{"ETag":{"description":"Release- and request-specific validator","schema":{"type":"string"}},"Link":{"description":"Typed links for the response, including rel=\"next\" when another bounded CSV page exists","schema":{"type":"string"}},"X-LMP-Dataset-Revision":{"description":"Coherent public release key","schema":{"type":"string"}},"X-LMP-Next-Cursor":{"description":"Opaque cursor for the next CSV page; absent on the final page","schema":{"type":"string","maxLength":256}}},"content":{"text/csv":{"schema":{"type":"string"}}}},"304":{"description":"The supplied ETag still matches"},"400":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"No published observations match the valid filters (NO_MATCHING_PRICES)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoMatchingPricesError"}}}},"409":{"description":"The cursor belongs to a different dataset release (STALE_CURSOR)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StaleCursorError"}}}},"503":{"description":"Structured public API error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"securitySchemes":{"memberSession":{"type":"apiKey","in":"cookie","name":"lmp_session","description":"A signed-in LMP Member or Pro session."}},"parameters":{"Species":{"name":"species","in":"query","schema":{"type":"string","enum":["goat","sheep","cattle"]}},"Class":{"name":"class","in":"query","schema":{"type":"string","enum":["unclassified_goats","unclassified_sheep","kids","nannies_does","bucks_billies","wethers_muttons","lambs","ewes","rams_bucks","steers","heifers","cows","bulls","calves","cow_calf_pairs","other_cattle"]}},"Purpose":{"name":"purpose","in":"query","schema":{"type":"string","enum":["slaughter","replacement","stocker","feeder","show","breeding"]}},"BreedType":{"name":"breed_type","in":"query","schema":{"type":"string","enum":["meat_goat","dairy_miniature","angora","hair_sheep","wool_sheep","beef_cattle","dairy_cattle","crossbred_cattle"]}},"WeightBand":{"name":"weight_band","in":"query","schema":{"type":"string","enum":["unreported","20-39","40-59","60-79","80-109","110-plus","under-300","300-399","400-499","500-599","600-699","700-799","800-999","1000-plus"]}},"Location":{"name":"location","in":"query","description":"Namespaced published location selector: all, state:CC:AA, region:ID, or market:ID","schema":{"type":"string","pattern":"^(?:all|state:[A-Z]{2}:[A-Z0-9]{2,3}|region:[A-Za-z0-9][A-Za-z0-9._:-]{0,127}|market:[A-Za-z0-9][A-Za-z0-9._:-]{0,127})$"}},"WeightLb":{"name":"weight_lb","in":"query","schema":{"type":"string"}},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},"Cursor":{"name":"cursor","in":"query","schema":{"type":"string","maxLength":256}}},"schemas":{"ExactDecimal":{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"Citation":{"type":"object","properties":{"publisher_name":{"type":"string","const":"Livestock Market Prices"},"canonical_url":{"type":"string","format":"uri"},"primary_sources":{"minItems":1,"type":"array","items":{"type":"object","properties":{"publisher_name":{"type":"string","minLength":1},"report_url":{"type":"string","format":"uri"}},"required":["publisher_name","report_url"],"additionalProperties":false}},"sale_dates":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dataset_revision":{"type":"string","minLength":1},"methodology_version":{"type":"string","minLength":1},"statistic_type":{"type":"string","enum":["reported_range","reported_average","reported_weighted_average","publisher_top_of_market_range","derived_midpoint","derived_valuation"]},"attribution_text":{"type":"string","minLength":1},"rights_url":{"type":"string","format":"uri"},"use_requirements":{"type":"object","properties":{"source_attribution_required":{"type":"boolean","const":true},"source_link_required":{"type":"boolean","const":true},"claim_as_original_data_prohibited":{"type":"boolean","const":true},"terms_url":{"type":"string","const":"https://livestockmarketprices.com/terms#terms-sources"}},"required":["source_attribution_required","source_link_required","claim_as_original_data_prohibited","terms_url"],"additionalProperties":false}},"required":["publisher_name","canonical_url","primary_sources","sale_dates","retrieved_at","dataset_revision","methodology_version","statistic_type","attribution_text","rights_url","use_requirements"],"additionalProperties":false},"Meta":{"type":"object","required":["api_version","dataset_revision","methodology_version","applied_filters","next_cursor","generated_at"],"additionalProperties":false,"properties":{"api_version":{"type":"string","const":"1.3.0-alpha.1"},"dataset_revision":{"type":"string"},"methodology_version":{"type":"string"},"applied_filters":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"}]}},"next_cursor":{"type":["string","null"]},"generated_at":{"type":"string","format":"date-time"}}},"PriceObservation":{"type":"object","description":"A normalized observation with exact weight/price strings, all reported quote records, and release/source provenance.","required":["id","report_id","market","sale_date","report_status","species","classification","normalized_class","raw_class","qualifiers","weight","quote","quotes","head_count","head_count_scope","boundary_semantics","provenance","citation"],"properties":{"id":{"type":"string"},"report_id":{"type":"string"},"market":{"type":"object","additionalProperties":true},"sale_date":{"type":"string","format":"date"},"report_status":{"type":"string","enum":["preliminary","final","corrected"]},"species":{"type":"string","enum":["goat","sheep","cattle"]},"classification":{"type":"object","additionalProperties":false,"required":["category_key","class_code","purpose_code","breed_type_code","sex_code","life_stage_code","quality_grade_code"],"properties":{"category_key":{"type":"string"},"class_code":{"type":"string","enum":["unclassified_goats","unclassified_sheep","kids","nannies_does","bucks_billies","wethers_muttons","lambs","ewes","rams_bucks","steers","heifers","cows","bulls","calves","cow_calf_pairs","other_cattle"]},"purpose_code":{"type":"string","enum":["slaughter","replacement","stocker","feeder","show","breeding","unknown"]},"breed_type_code":{"type":"string","enum":["meat_goat","dairy_miniature","angora","hair_sheep","wool_sheep","beef_cattle","dairy_cattle","crossbred_cattle","not_reported"]},"sex_code":{"type":"string","pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"},"life_stage_code":{"type":"string","pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"},"quality_grade_code":{"type":"string","pattern":"^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"}}},"normalized_class":{"type":"string"},"raw_class":{"type":"string"},"qualifiers":{"type":"array","items":{"type":"string"}},"unit_inference":{"type":"object","additionalProperties":false,"description":"LMP-applied unit assumption. Evidence score is a rule rubric, not a probability; source_value remains null.","required":["code","rule","field","source_value","applied_value","evidence_score","score_is_probability","explanation"],"properties":{"code":{"const":"inferred_quotation_unit"},"rule":{"type":"string","enum":["cattlemens-unit-v1","pearsall-unit-v1","gonzales-unit-v1","brazos-valley-unit-v1","columbus-unit-v1","caldwell-unit-v1","comanche-unit-v1","four-county-unit-v1","coryell-unit-v1","center-unit-v1","hallettsville-unit-v1","wichita-unit-v1","hondo-unit-v1","east-texas-unit-v1","edinburg-unit-v1","decatur-unit-v1","beeville-unit-v1","abilene-unit-v1"]},"field":{"const":"quotation_unit"},"source_value":{"type":"null"},"applied_value":{"type":"string","enum":["per_cwt","per_lb","per_head","per_pair"]},"evidence_score":{"const":85},"score_is_probability":{"const":false},"explanation":{"type":"string","maxLength":500}}},"weight":{"type":"object","additionalProperties":true},"quote":{"type":"object","additionalProperties":true,"required":["currency","unit","measurement_basis"],"properties":{"currency":{"type":"string","const":"USD"},"unit":{"type":"string","enum":["USD_PER_CWT","USD_PER_LB","USD_PER_HEAD","USD_PER_PAIR"]},"measurement_basis":{"type":"string","enum":["liveweight","other"]}}},"quotes":{"type":"array","items":{"type":"object","additionalProperties":true}},"head_count":{"type":["integer","null"],"minimum":0},"head_count_scope":{"type":["string","null"]},"boundary_semantics":{"type":"object","required":["lower","upper"],"additionalProperties":false,"properties":{"lower":{"type":"string","enum":["inclusive","exclusive","unspecified","open"]},"upper":{"type":"string","enum":["inclusive","exclusive","unspecified","open"]}}},"provenance":{"type":"object","additionalProperties":true},"citation":{"$ref":"#/components/schemas/Citation"}}},"PricesResponse":{"type":"object","required":["data","meta","citation"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PriceObservation"}},"meta":{"$ref":"#/components/schemas/Meta"},"citation":{"$ref":"#/components/schemas/Citation"}}},"PublicRelease":{"type":"object","required":["id","key","observation_count","quote_count","period_start","period_end"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"key":{"type":"string","minLength":1},"observation_count":{"type":"integer","minimum":0},"quote_count":{"type":"integer","minimum":0},"period_start":{"type":"string","format":"date"},"period_end":{"type":"string","format":"date"}}},"ReportRecord":{"type":"object","required":["id","source_report_key","report_family_slug","title","report_kind","presentation_role","report_status","sale_date","sale_timezone","report_period_start","report_period_end","reported_receipt_count","quote_basis_label","canonical_url","primary_source_url","source_endpoint_url","market","publisher","revision","release","artifact","observations","citation"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"source_report_key":{"type":"string","minLength":1},"report_family_slug":{"type":"string","enum":["sheep-goat","cattle"]},"title":{"type":"string","minLength":1},"report_kind":{"type":"string","minLength":1},"presentation_role":{"type":"string","minLength":1},"report_status":{"type":"string","enum":["preliminary","final","corrected"]},"sale_date":{"type":"string","format":"date"},"sale_timezone":{"type":"string","minLength":1},"report_period_start":{"type":["string","null"],"format":"date"},"report_period_end":{"type":["string","null"],"format":"date"},"report_context":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"methodologyVersion":{"type":"string","const":"source-report-context-v1"},"sourcePriceRowCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":10000},{"type":"null"}]},"counts":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120},"species":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["cattle","goat","sheep"]}},"scope":{"type":"string","enum":["report","species","class","class_group","species_group"]},"head":{"type":"integer","minimum":0,"maximum":10000000}},"required":["label","species","scope","head"],"additionalProperties":false}},"combinedQuotes":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120},"species":{"minItems":2,"maxItems":3,"type":"array","items":{"type":"string","enum":["cattle","goat","sheep"]}},"quotationUnit":{"type":"string","const":"per_head"},"priceLowUnits":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"priceHighUnits":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"priceScale":{"type":"number","const":2}},"required":["label","species","quotationUnit","priceLowUnits","priceHighUnits","priceScale"],"additionalProperties":false}},"notableSales":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120},"priceUnits":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"priceScale":{"type":"number","const":2},"qualification":{"type":"string","const":"selected_sale_not_market_range"}},"required":["label","priceUnits","priceScale","qualification"],"additionalProperties":false}}},"required":["methodologyVersion","sourcePriceRowCount","counts","combinedQuotes"],"additionalProperties":false},{"type":"null"}]},"reported_receipt_count":{"type":["integer","null"],"minimum":0},"quote_basis_label":{"type":["string","null"]},"canonical_url":{"type":"string","format":"uri"},"primary_source_url":{"type":"string","format":"uri"},"source_availability":{"type":"string","enum":["available","unavailable"]},"source_endpoint_url":{"type":"string","format":"uri"},"market":{"type":"object","required":["id","name","locality","state","country","canonical_url","region_role"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"locality":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1},"canonical_url":{"type":"string","format":"uri"},"region_role":{"type":"string","enum":["member","comparison_benchmark"]}}},"publisher":{"type":"object","required":["id","name","canonical_url"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"canonical_url":{"type":["string","null"],"format":"uri"}}},"revision":{"type":"object","required":["id","number","source_label","content_sha256","reviewed_at"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"number":{"type":"integer","minimum":1},"source_label":{"type":["string","null"]},"content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"reviewed_at":{"type":"string","format":"date-time"}}},"release":{"type":"object","required":["id","key","publication_decision_id","publication_policy_version"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"key":{"type":"string","minLength":1},"publication_decision_id":{"type":"string","minLength":1},"publication_policy_version":{"type":"string","minLength":1}}},"artifact":{"type":"object","required":["sha256","retrieved_at","source_published_at"],"additionalProperties":false,"properties":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"retrieved_at":{"type":"string","format":"date-time"},"source_published_at":{"type":["string","null"],"format":"date-time"}}},"observations":{"type":"array","items":{"$ref":"#/components/schemas/PriceObservation"}},"citation":{"$ref":"#/components/schemas/Citation"}}},"ReportResponse":{"type":"object","required":["data","meta","citation"],"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ReportRecord"},"meta":{"$ref":"#/components/schemas/Meta"},"citation":{"$ref":"#/components/schemas/Citation"}}},"CoverageRecord":{"type":"object","required":["release","report_count","market_count","observation_count","earliest_sale_date","latest_sale_date","markets","regions","species","limitations"],"additionalProperties":false,"properties":{"release":{"$ref":"#/components/schemas/PublicRelease"},"report_count":{"type":"integer","minimum":0},"market_count":{"type":"integer","minimum":0},"observation_count":{"type":"integer","minimum":0},"earliest_sale_date":{"type":"string","format":"date"},"latest_sale_date":{"type":"string","format":"date"},"markets":{"type":"array","items":{"type":"object","required":["id","name","locality","state","country","county","county_fips","canonical_url","region_role","earliest_sale_date","latest_sale_date","observation_count","location"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"locality":{"type":"string","minLength":1},"state":{"type":"string","minLength":1},"country":{"type":"string","minLength":1},"county":{"type":["string","null"]},"county_fips":{"type":["string","null"],"pattern":"^[0-9]{3}$"},"published_species":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["cattle","goat","sheep"]}},"reported_species":{"type":"array","uniqueItems":true,"description":"Source-reported species including combined groups; not a claim of separate price series.","items":{"type":"string","enum":["cattle","goat","sheep"]}},"canonical_url":{"type":"string","format":"uri"},"region_role":{"type":"string","enum":["member","comparison_benchmark"]},"earliest_sale_date":{"type":"string","format":"date"},"latest_sale_date":{"type":"string","format":"date"},"observation_count":{"type":"integer","minimum":0},"location":{"type":"object","additionalProperties":false,"required":["address_line1","postal_code","latitude","longitude","source_url","verified_at"],"properties":{"address_line1":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"source_url":{"type":["string","null"],"format":"uri"},"verified_at":{"type":["string","null"],"format":"date-time"}}}}}},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","slug","methodology_version","country","state","market_ids"],"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"slug":{"type":"string","minLength":1},"methodology_version":{"type":"string","minLength":1},"country":{"type":"string","minLength":2,"maxLength":2},"state":{"type":["string","null"]},"market_ids":{"type":"array","items":{"type":"string","minLength":1}}}}},"species":{"type":"array","items":{"type":"object","required":["code","earliest_sale_date","latest_sale_date","observation_count"],"additionalProperties":false,"properties":{"code":{"type":"string","enum":["goat","sheep","cattle"]},"earliest_sale_date":{"type":"string","format":"date"},"latest_sale_date":{"type":"string","format":"date"},"observation_count":{"type":"integer","minimum":0}}}},"limitations":{"type":"array","items":{"type":"string"}}}},"CoverageResponse":{"type":"object","required":["data","meta","citation"],"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/CoverageRecord"},"meta":{"$ref":"#/components/schemas/Meta"},"citation":{"$ref":"#/components/schemas/Citation"}}},"MethodologyRecord":{"type":"object","required":["id","kind","version","name","definition","canonical_url","status","effective_at"],"additionalProperties":false,"properties":{"id":{"type":"string","minLength":1},"kind":{"type":"string","enum":["publication","regional_reference","valuation","haul","sell_or_hold","index"]},"version":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"definition":{"type":"string","minLength":1},"canonical_url":{"type":"string","format":"uri"},"status":{"type":"string","const":"active"},"effective_at":{"type":"string","format":"date-time"}}},"MethodologiesResponse":{"type":"object","required":["data","meta","citation"],"additionalProperties":false,"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MethodologyRecord"}},"meta":{"$ref":"#/components/schemas/Meta"},"citation":{"$ref":"#/components/schemas/Citation"}}},"ValuationRequest":{"type":"object","properties":{"observation_id":{"type":"string","minLength":1,"maxLength":256},"animal_count":{"type":"integer","minimum":1,"maximum":10000},"average_weight_lb":{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"statistic":{"type":"string","enum":["reported_low","reported_high","reported_average","reported_weighted_average","range_midpoint"]}},"required":["observation_id","animal_count","average_weight_lb","statistic"],"additionalProperties":false},"ValuationResult":{"type":"object","properties":{"gross_value_usd":{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"price_usd_per_cwt":{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"animal_count":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"average_weight_lb":{"type":"string","pattern":"^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$"},"approximation":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"citation":{"type":"object","properties":{"publisher_name":{"type":"string","const":"Livestock Market Prices"},"canonical_url":{"type":"string","format":"uri"},"primary_sources":{"minItems":1,"type":"array","items":{"type":"object","properties":{"publisher_name":{"type":"string","minLength":1},"report_url":{"type":"string","format":"uri"}},"required":["publisher_name","report_url"],"additionalProperties":false}},"sale_dates":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dataset_revision":{"type":"string","minLength":1},"methodology_version":{"type":"string","minLength":1},"statistic_type":{"type":"string","const":"derived_valuation"},"attribution_text":{"type":"string","minLength":1},"rights_url":{"type":"string","format":"uri"},"use_requirements":{"type":"object","properties":{"source_attribution_required":{"type":"boolean","const":true},"source_link_required":{"type":"boolean","const":true},"claim_as_original_data_prohibited":{"type":"boolean","const":true},"terms_url":{"type":"string","const":"https://livestockmarketprices.com/terms#terms-sources"}},"required":["source_attribution_required","source_link_required","claim_as_original_data_prohibited","terms_url"],"additionalProperties":false}},"required":["publisher_name","canonical_url","primary_sources","sale_dates","retrieved_at","dataset_revision","methodology_version","statistic_type","attribution_text","rights_url","use_requirements"],"additionalProperties":false}},"required":["gross_value_usd","price_usd_per_cwt","animal_count","average_weight_lb","approximation","warnings","citation"],"additionalProperties":false},"ValuationResponse":{"type":"object","required":["data","meta","citation"],"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ValuationResult"},"meta":{"$ref":"#/components/schemas/Meta"},"citation":{"$ref":"#/components/schemas/Citation"}}},"HealthResponse":{"type":"object","required":["status","release"],"additionalProperties":false,"properties":{"status":{"type":"string","const":"ready"},"release":{"$ref":"#/components/schemas/PublicRelease"}}},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","minLength":1},"message":{"type":"string","minLength":1},"details":{},"request_id":{"type":"string","minLength":1}},"required":["code","message","request_id"],"additionalProperties":false}},"required":["error"],"additionalProperties":false},"NoMatchingPricesError":{"allOf":[{"$ref":"#/components/schemas/ApiError"},{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","details"],"properties":{"code":{"type":"string","const":"NO_MATCHING_PRICES"},"details":{"type":"object","required":["applied_filters","dataset_revision"],"additionalProperties":false,"properties":{"applied_filters":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"}]}},"dataset_revision":{"type":"string","minLength":1}}}}}}}]},"StaleCursorError":{"allOf":[{"$ref":"#/components/schemas/ApiError"},{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","details"],"properties":{"code":{"type":"string","const":"STALE_CURSOR"},"details":{"type":"object","required":["cursor_dataset_revision","current_dataset_revision"],"additionalProperties":false,"properties":{"cursor_dataset_revision":{"type":"string","minLength":1},"current_dataset_revision":{"type":"string","minLength":1}}}}}}}]},"RequestBodyTimeoutError":{"allOf":[{"$ref":"#/components/schemas/ApiError"},{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code"],"properties":{"code":{"type":"string","const":"REQUEST_BODY_TIMEOUT"}}}}}]},"ValuationRateLimitedError":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code","message"],"additionalProperties":false,"properties":{"code":{"type":"string","const":"VALUATION_RATE_LIMITED"},"message":{"type":"string","minLength":1}}}}},"ValuationRateLimitUnavailableError":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code","message"],"additionalProperties":false,"properties":{"code":{"type":"string","const":"VALUATION_RATE_LIMIT_UNAVAILABLE"},"message":{"type":"string","minLength":1}}}}},"ValuationUnavailableError":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/ValuationRateLimitUnavailableError"}]}}}}