inseminations Endpoint
The inseminations endpoint provides bulk data related to BRED and TRANSFER events for all animals in the herd. BRED events are recorded when an animal is bred using artificial insemination or mates with a bull. TRANSFER events are recorded when an embryo is transferred to a recipient animal. All animals (live, sold, and dead) are included in the response for this endpoint.
|
|
|
| PATH PARAMETERS | |
|
{location-id}* |
Location identifier. For routes with “com.vas.dairies.id”, {location-id} is a VAS-specific dairy id, commonly referred to as {dairyId} when not part of an ICAR |
|
QUERY PARAMETERS |
|
|
page |
Sets the page number to display in the results. If no parameter is defined, page 1 displays. |
|
pageSize |
Sets the number of items to display on one page of results. If no parameter is defined, the response includes 10 items per page. The maximum pageSize is 1000. |
|
start-date-time |
Specifies a start date and time (optional) for which to include results. Format the date as YYYY-MM-DD. To include a start time as well, add Thh:mm:ss to the date. A "T" is required to separate the date and time.  Examples
If no parameter is defined, all results for the past year are included. To specify a date range, include both a start-date-time and an end-date-time. |
|
end-date-time |
Specifies an end date and time (optional) for which to include results. Format the date as YYYY-MM-DD. To include an end time as well, add Thh:mm:ss to the date. A "T" is required to separate the date and time. Examples
If no parameter is defined, all results for the past year are included. To specify a date range, include both a start-date-time and an end-date-time. |
Sample Request (cURL)
curl -X GET \
https://platform-vendor-api.vas.com/locations/com.vas.dairies.id/{location-id}/inseminations \
-H 'Authorization: bearer {authorization token}' \
-H 'X-API-Key: {API key}'
Sample Response (JSON)
{
"view": {
"pageSize": 10,
"currentPage": 1,
"totalPages": 1,
"totalItems": 2
},
"member": [
{
"meta": {
"modified": "2021-01-13T21:33:27+00:00",
"created": "2021-01-13T21:33:27+00:00"
},
"animal": {
"identifier": {
"id": "100129173",
"scheme": "com.vas.animals.id"
},
"alternativeIdentifiers": [
{
"id": "21323",
"scheme": "com.vas.animals.managementNumber"
},
{
"id": "",
"scheme": "com.vas.animals.name"
},
{
"id": "840003148282957",
"scheme": "com.vas.animals.registrationId"
},
{
"id": "840003148282957",
"scheme": "com.vas.animals.electronicId"
}
]
},
"location": {
"id": "8",
"scheme": "com.vas.dairies.id"
},
"pen": {
"identifier": {
"id": "57123",
"scheme": "com.vas.pens.id"
},
"alternativeIdentifiers": [
{
"id": "28",
"scheme": "com.vas.pens.number"
}
]
},
"eventDateTime": "2021-01-13T21:00:00+00:00",
"eventName": "BRED",
"remark": "",
"daysInMilk": "42",
"ageInDays": "",
"lactation": "1",
"timesBredAtEvent": "1",
"isEmbryoTransfer": "False",
"breedingCode": "C",
"breedingCodeDescription": "",
"breedingResultCode": " ",
"breedingResultCodeDescription": "",
"inseminationType": "Insemination",
"straw": {
"sire": {
"sireIdentifiers": [
{
"id": "0",
"scheme": "com.vas.sire.Id"
}
],
"sireAlternativeIdentifiers": [
{
"id": "",
"scheme": "com.vas.sire.isoId"
},
{
"id": "161310",
"scheme": "com.vas.sire.default"
}
],
"sireOfficialName": "",
"studCode": "0",
"sireBreed": ""
}
}
},
{
"meta": {
"modified": "2021-01-13T21:08:28+00:00",
"created": "2021-01-13T21:08:28+00:00"
},
"animal": {
"identifier": {
"id": "100129173",
"scheme": "com.vas.animals.id"
},
"alternativeIdentifiers": [
{
"id": "21323",
"scheme": "com.vas.animals.managementNumber"
},
{
"id": "",
"scheme": "com.vas.animals.name"
},
{
"id": "840003148282957",
"scheme": "com.vas.animals.registrationId"
},
{
"id": "840003148282957",
"scheme": "com.vas.animals.electronicId"
}
]
},
"location": {
"id": "8",
"scheme": "com.vas.dairies.id"
},
"pen": {
"identifier": {
"id": "57123",
"scheme": "com.vas.pens.id"
},
"alternativeIdentifiers": [
{
"id": "28",
"scheme": "com.vas.pens.number"
}
]
},
"eventDateTime": "2021-01-13T08:00:00+00:00",
"eventName": "TRANSFER",
"remark": "5-2 C",
"daysInMilk": "42",
"ageInDays": "",
"lactation": "1",
"timesBredAtEvent": "1",
"inseminationType": "Implantation",
"isEmbryoTransfer": "True",
"embryo": {
"id": {
"id": "658",
"scheme": "com.vas.embryo.Id"
},
"donorIdentifiers": [
{
"id": "",
"scheme": "com.vas.donor.donorDamRegistrationId"
},
{
"id": "12467",
"scheme": "com.vas.donor.donorDamNumber"
}
],
"sire": {
"sireIdentifiers": [
{
"id": "",
"scheme": "com.vas.sire.id"
}
],
"sireAlternativeIdentifiers": [
{
"id": "161310",
"scheme": "com.vas.sire.default"
}
]
},
"embryoAge": "0.0",
"embryoBreed": "WA",
"breedingCode": "C",
"breedingCodeDescription": "frozen Conv"
}
}
]
}| Data Point | Data Type | Definition | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
meta data
The meta data specifies historical information for the animal record.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
animal data
The animal data includes multiple data points to identify the animal.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
location data
The location data specifies the animal's dairyId information.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
pen data
The pen data specifies the animal's pen information.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
eventDateTime |
string |
Date/time stamp (YYYY-MM-DDThh:mm:ss |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
eventName |
string |
BRED or TRANSFER (configurable by dairy in PULSE and/or DairyComp 305) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
remark |
string |
Additional information on the event, which may be automatically generated by PULSE and/or DairyComp 305, or manually entered |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
daysInMilk |
integer |
Number of days into current lactation. For dry cows, total days in most recent lactation prior to being dried off. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
ageInDays |
integer |
Number of days since the animal birth date |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
lactation |
integer |
Current lactation number |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
BRED event details
The following information is included for each BRED event.
TRANSFER event details
The following information is included for each TRANSFER event:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTTP Status Codes & Errors
| Status Code/Error | Description |
|---|---|
200 OK
|
Standard response for a successful HTTP request. |
201 Created
|
A |
202 Accepted
|
The server accepted the request and will execute it at a later point. |
204 No Content
|
The server successfully executed the method but returns no response body. |
400 Bad Request
|
Bad request. Depending on the endpoint, additional error details may be sent in the response. Use the strategies below to troubleshoot the error:
NOTE: The resource URI is case-sensitive. If you are encountering unexpected 400 errors, check your URI for correct capitalization of resource names.
|
401 Unauthorized
|
Authentication failed due to invalid authentication credentials. |
403 Forbidden
|
You are not permitted to access this resource. |
404 Not Found
|
The resource could not be found. It is possible that the resource has been moved or deleted, or that there is a typo in your request. |
405 Method Not Allowed
|
The requested method and resource are not compatible. |
429 Too Many Requests
|
You sent too many requests within a given period and exceeded the rate limit. |
500 Internal Server Error
|
A VAS server error has occurred and the request cannot be fulfilled. |
502 Bad Gateway
|
The server did not receive a timely response from another server. |
503 Service Unavailable
|
The server is not available, usually due to overloading or maintenance issues. |
504 Gateway Timeout
|
The server, while acting as a gateway or proxy, cannot get a response in time. |
method successfully created a resource.Last Built: November 21, 2024
Data Disclaimer
The VAS Developer API is designed to align with industry standards, including NAAB National Association of Animal Breeders. www.naab-css.org and ICAR International Committee for Animal Recording (ICAR) is a global organization focused on the standardization of animal identification, recording, genetic evaluation, and data management.. However, due to the customizable nature of VAS applications, we cannot guarantee that our users' data comply with industry standards. VAS partners' use of the API is at their sole discretion and risk. The VAS Developer API is provided "as is," including any potential errors or missing data.