1. Home
  2. /
  3. Resource Types
  4. /
  5. Livestock
  6. /
  7. Livestock Movements
  8. /
  9. Animal Death

Resource Type: Animal-Death

URLs

Get all animal death events that you have access to.

GET /data/livestock/movement/animal-deaths

Get an individual animal death event for the specified DeathId, the Id is required. 

GET /data/livestock/movement/animal-deaths/{DeathId}

Get all animal death events that are linked to the provided HoldingId, holding Id is required.

GET /data/holdings/{HoldingId}/livestock/movement/animal-deaths

Get an individual animal death event with a given HoldingID and DeathId, both Ids are required

GET /data/holdings/{HoldingId}/livestock/movement/animal-deaths/{DeathId}

Response Structure

A call to the animal death event endpoints returns the following fields.

{
  "self": "string",
  "location": {...},
  "meta": {...},
  "resourceType": "/livestock/movement/animal-death",
  "contemporaryGroup": "string",
  "eventDateTime": "DateTimeOffset",
  "id": "string",
  "remark" : "string",
  "responsible" : "string",
  "traitLabel" : {...},
  "animal" : {...},
  "consignment": {...},
  "deathMethod" : "string",
  "deathReason" : "string",
  "disposalMethod" : "string",
  "disposalOperator" : "string",
  "disposalReference" : "string",
  "explanation" : "string",
}
Response Item Description Data Type
Self A link to this specific Animal Death URI
Location An identifier for the location of the Animal Death Identifier
Meta Meta data for the resource Metadata
Resource Type The fixed discriminator for the animal death resource type.
Value: /livestock/movement/animal-death		 String
ContemporaryGroup For manually recorded events, record any contemporary group code that would affect statistical analysis. String
Event Date Time The datetime when the event happened. Shall be UTC format with Z, specified in RFC3339. Date/Time
Id The Pure Farming Id of this death event UUID
Remark A comment or remark field for additional user-specified information about the event. String
Responsible Use if an observation is manually recorded, or an event is carried out or authorised by a person. String
Trait Label If the event represents a formal trait, this identifies the recording system and trait. Identifier
Animal Unique animal scheme and identifier combination. Identifier
Consignment Consignment information for a movement (arrival, departure). Consignment
Death Method How the animal was killed (Valid values: Accident, Culled, Lost, Other, Perished, Slaughter, Theft) Enumeration
Death Reason The reason for the death (Valid values: Missing, Parturition, Disease, Accident, Consumption, Culled, Other, Unknown, Age, Mastitis, Production, LegOrClaw, MilkingAbility, Nutrition, Fertility) Enumeration
Disposal Method How the animal was disposed of (Valid values: ApprovedService, Consumption, OnPremise, Other) Enumeration
Disposal Operator Disposal operator official name (should really be schema.org/organization). String
Disposal Reference Reference (receipt, docket, or ID) for disposal. String
Explanation Free text explanation of the reason for death. String