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

Resource Type: Group-Departure

URLs

Get all group departure events that you have access to.

GET /data/livestock/movement/group-departures

Get an individual group departure event for the specified GroupDepartureId, the Id is required. 

GET /data/livestock/movement/group-departures/{GroupDepartureId}

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

GET /data/holdings/{HoldingId}/livestock/movement/group-arrivals

Get an individual group departure event with a given HoldingId and GroupDepartureId, both Ids are required

GET /data/holdings/{HoldingId}/livestock/movement/group-arrivals/{GroupDepartureId}

Response Structure

A call to the group departure event endpoints returns the following fields.

{
  "id": "string",
  "resourceType": "/livestock/movement/group-departure",
  "groupMethod": "string",
  "traitLabel" : {...},
  "consignment": {...},
  "contemporaryGroup": "string",
  "countObserved": "number",
  "departureReason" : "string",
  "departureKind" : "string",
  "eventDateTime": "DateTimeOffset",
  "explanation" : "string",
  "embeddedAnimalSet": {...},
  "inventoryClassification": {...},
  "location": {...},
  "remark" : "string",
  "responsible" : "string",
  "meta": {...},
  "animalSetReference": {...},
  "self": "string"
}
Response Item Description Data Type
Id The Pure Farming Id of this arrival event. UUID
Resource Type The fixed discriminator for the group departure resource type.
Value: /livestock/movement/group-departure		 String
Group Method Indicates whether the event references an existing animal set, has an embedded animal set, or an inventory classification. (Valid values: ExistingAnimalSet, EmbeddedAnimalSet, InventoryClassification, EmbeddedAnimalSetAndInventoryClassification) Enumeration
Trait Label If the event represents a formal trait, this identifies the recording system and trait. Identifier
Consignment Consignment information for a movement (arrival, departure). Consignment
ContemporaryGroup For manually recorded events, record any contemporary group code that would affect statistical analysis. String
Count Observed Summarises the number of animals observed in the event. Generally the number of animals in the group, but sometimes a sample. Number
Departure Reason The Reason for the departure (Valid values: Purchase, Internal Transfer, Imported, Stud Service, Stud Service Return, Slaughter, Agistment, Agistment Return, Show, Show Return, Sale, Sale Return, Other) Enumeration
Departure Kind The kind of departure event (Valid values: Agistment, AgistmentReturn, Export, InternalTransfer, Newborn, Other, Sale, SaleReturn, Show, ShowReturn, Slaughter, StudService, StudServiceReturn) Enumeration
Event Date Time The datetime when the event happened. Shall be UTC format with Z, specified in RFC3339. Date/Time
Explanation Free text explanation of the reason for departure. String
Embeded Animal Set Specifies the set of animals as a list of member animal identifiers. Embedded Animal Set
Inventory Classification Describe the group of animals by their characteristics rather than animal identifiers. Inventory Classification
Location An identifier for the location of the group departure. Identifier
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
Meta Meta data for the resource. Metadata
Animal Set Reference Reference an existing animal set by ID and optionally URI. ResourceReference
Self A link to this specific group departure. URI