Get livestock by id
GET /obp/v7.0.0/banks/dylan-bank/dynamic-entities/livestock/LIVESTOCK_ID
OBPv7.0.0-dynamicEntity_getSinglelivestock_dylan-bank Roles: CanGetDynamicEntityRecord_livestock(per bank) _Livestock(dylan-bank)Dynamic-EntityDynamic
Get livestock by id.
Records a group of animals of the same species kept by an operator, either grazing on a parcel or housed on a farm. Livestock data is not currently within CRCF scope (enteric fermentation 3.A and manure management 3.B are under Commission review until July 2026) but is included here as a v2 entity to support future certification methodologies and Scope 3 supply chain reporting. This Dynamic Entity is part of OGCR.
Property List:
- livestock_id: Unique internal identifier automatically assigned to this livestock herd record.
- parcel_id: The parcel where this herd grazes, if applicable. Null for housed animals (pigs, poultry). When populated, links the herd to parcel geometry so that grazing impacts on soil carbon (compaction, manure deposition) can be spatially attributed.
- species: The animal species. Controlled vocabulary aligned with IPCC 3.A/3.B emission factor categories. Determines which emission factors apply for enteric fermentation and manure management.
- breed: The breed of the animals in this herd. Breed affects feed conversion efficiency and methane emission rates, and may be required by future certification methodologies.
- head_count: The number of individual animals in this herd at the time of recording. Used to calculate total livestock units (LU) for the holding and to scale emission estimates.
- head_count_date: The date on which the head count was recorded. Herd size can change over the year (births, sales, slaughter), so the date is required to interpret the figure correctly.
- livestock_unit: Standardised livestock unit (LU) value for this herd, calculated from head count and species. One LU equals one adult dairy cow (500 kg). Used for cross-species comparisons and regulatory thresholds (e.g., nitrates directive).
- production_system: The management system under which these animals are kept. Affects both emission factors and carbon farming practice eligibility. Controlled vocabulary: grazing (animals outdoors year-round), mixed (indoor/outdoor), housed (indoor year-round), feedlot.
- manure_management_system: How animal manure is collected, stored, and applied. This is the primary factor driving methane and N2O emissions under IPCC category 3.B. Controlled vocabulary: slurry_tank, solid_storage, anaerobic_digester, pasture_range, biogas_with_flaring.
- feed_type: The primary feed source for this herd. Feed composition is the main determinant of enteric fermentation rates (IPCC 3.A). High-quality pasture produces less methane per unit of output than low-quality roughage or concentrate-heavy rations.
- avg_daily_weight_gain_kg: Average daily live weight gain per animal, in kilograms. Recorded for beef cattle only. Used with feed conversion ratios to estimate feed intake (this is for enteric fermentation emissions.)
- milk_yield_litres_per_day: Average daily milk production per cow, in litres. Recorded for dairy cattle only. Higher-yielding cows tend to have lower emission intensity per litre of milk, which is relevant for Scope 3 intensity-based reporting.
MethodRouting settings example:
<details>
{
"is_bank_id_exact_match":false,
"method_name":"dynamicEntityProcess",
"connector_name":"rest_vMar2019",
"bank_id_pattern":".*",
"parameters":[
{
"key":"entityName",
"value":"livestock"
}
{
"key":"url",
"value":"http://mydomain.com/xxx"
}
]
}
</details>
User Authentication is Required. The User must be logged in. The Application must also be authenticated.
Example success response
{
"bank_id": "dylan-bank",
"livestock": {
"livestock_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"parcel_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"species": "cattle_dairy",
"breed": "Holstein Friesian",
"head_count": 85,
"head_count_date": "2026-01-01",
"livestock_unit": 85,
"production_system": "grazing",
"manure_management_system": "slurry_tank",
"feed_type": "pasture",
"avg_daily_weight_gain_kg": 1.1,
"milk_yield_litres_per_day": 28.5
},
"metadata": {
"created": {
"at": "2026-09-30T10:12:00Z",
"user_id": "a9f2c7e1-3d4b-4a5c-8e6f-7a8b9c0d1e2f",
"on_behalf_of_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
},
"updated": {
"at": "2026-09-30T11:40:00Z",
"user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"on_behalf_of_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
}
}
}Possible errors (3)
- OBP-20001: User not logged in. Authentication is required!
- OBP-20006: User is missing one or more roles:
- OBP-50000: Unknown Error.