{dairyCowId} Endpoint

Each cow in a dairy has a VAS-specific A data value that originates from the VAS product line. identifier, which is required to request additional details (as a nested resource) for that cow. All animals (live, sold, and dead) are included in the response for this endpoint.

NOTE: This endpoint is only available in a deprecated version of the VAS Developer API. Please reach out to us at API Support to transition to the latest version of the VAS Developer API.

NOTE: This endpoint does not currently adhere to ICAR standards.

https://platform-vendor-api.vas.com/dairies/{dairyId}/cows/{dairyCowId}
PATH PARAMETERS
{dairyId}* integer	VAS-specific dairy identifier
{dairyCowId}* integer	VAS-specific dairy cow identifier. This number is used in all VAS products, including PULSE and DairyComp 305. This identifier is unique to each animal in the VAS suite of products, and is the most stable and reliable source of animal identification data. dairyCowId differs from the animal's cowNumber, displayCowNumber, EID 15-digit electronic ID number associated with the animal eartag, and isoId.
* Required

Sample Response (JSON)

{
    "id": 123456,
    "dairyId": 123,
    "createdAt": "2020-01-17T03:10:39+00:00",
    "updatedAt": "2020-01-17T03:10:39+00:00",
    "animalType": 2,
    "ageInDays": 1131,
    "abortionDate": null,
    "archiveDate": null,
    "beefWithdrawalDate": null,
    "birthDate": "2016-12-19T08:00:00+00:00",
    "breed": "H",
    "breedingSire": {
        "id": 21993,
        "sireDefault": "29H18471",
        "sireName": "RYDER",
        "isoId": "840003135245697",
        "breed": "H",
        "studCode": 0
    },
    "bullPenDate": "2018-07-01T07:00:00+00:00",
    "conceptionDate": "2018-03-26T07:00:00+00:00",
    "conceptionSire": {
        "id": 21993,
        "sireDefault": "29H18471",
        "sireName": "RYDER",
        "isoId": "840003135245697",
        "breed": "H",
        "studCode": 0
    },
    "cowName": null,
    "cowNumber": 18044,
    "displayCowNumber": "18044",
    "daysCarriedCalf": 669,
    "daysDry": 0,
    "daysInMilk": 0,
    "daysOpen": 0,
    "daysSinceLastHeat": 669,
    "disposalCode": 0,
    "dryDate": null,
    "damNumber": 932,
    "damRegistrationId": "840003128986107",
    "electronicId": "840003141414331",
    "enrollmentDate": "2016-12-19T08:00:00+00:00",
    "freshDate": null,
    "heatDate": "2018-03-26T07:00:00+00:00",
    "hospitalDate": null,
    "isoId": "840003141414331",
    "lactation": 0,
    "lastTreatmentDate": null,
    "matureEquivalentMilk": 0,
    "milkWithdrawalDate": null,
    "penNumber": 21,
    "pregOpenDate": "2018-05-04T07:00:00+00:00",
    "previousConceptionDate": null,
    "previousPenNumber": 51,
    "projectedCalving": "2018-12-31T08:00:00+00:00",
    "recheckDate": null,
    "relativeValue": 0,
    "reproductionCode": 5,
    "sire": {
        "id": 21886,
        "sireDefault": "523H1470",
        "sireName": "DION",
        "isoId": "840003012574855",
        "breed": "H",
        "studCode": 0
    },
    "timesBred": 3,
    "totalFat": 0,
    "totalMilk": 0,
    "totalProtein": 0,
    "totalSickDays": 0,
    "vetCode": 0,
    "isMale": false,
    "isAlive": true,
    "pen": {
        "id": 3300,
        "penNumber": 21,
        "zoneId": 23,
        "penType": 0,
        "capacity": 157
    },
    "soldDate": null,
    "deathDate": null,
    "herdStatus": 0,
    "hasMilkWitholding": false,
    "hasBeefWitholding": false,
    "note": "",
    "speciesType": 0
}

Response Schema

Data Point

Data Type

Definition

integer

VAS-specific dairy cow identifier. This number is used in all VAS products, including PULSE and DairyComp 305. This identifier is unique to each animal in the VAS suite of products, and is the most stable and reliable source of animal identification data. dairyCowId differs from the animal's cowNumber, displayCowNumber, EID, and isoId.

dairyId

integer

VAS-specific dairy identifier

createdAt

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC Coordinated Universal Time, also known as Greenwich Mean Time (GMT) time) of when the animal record was created. Learn more about VAS Developer API Date/Time Formatting.

updatedAt

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the last animal update. Learn more about VAS Developer API Date/Time Formatting.

animalType

integer

Animal type description:

0: Undefined
1: Calf
2: Heifer
3: Cow
4: Bull

ageInDays

integer

Number of days since the animal birth date

abortionDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of last abort event. Learn more about VAS Developer API Date/Time Formatting.

archiveDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal archive event. Learn more about VAS Developer API Date/Time Formatting.

beefWithdrawalDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of beef (meat) withdrawal period end. Starting at this date-time, the animal is cleared for slaughter. Learn more about VAS Developer API Date/Time Formatting.

birthDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal birth date. Learn more about VAS Developer API Date/Time Formatting.

breed

string

Breed name abbreviation. Learn more about VAS Developer API Cow Breeds.

breedingSire data

The breedingSire is the bull whose semen was used in the animal's latest breeding.

Data Point	Data Type	Definition
sireDefault	integer	Dairy-specific sire identifier
sireName	string	Sire name
isoId	string	15-digit ISO International Organization for Standardization, a global organization that promotes commercial and industrial standards. number associated with the animal eartag, often the same as the electronicID. If the electronicID changes, the isoId does not. The isoId is a unique on-farm animal identifier. VAS recommends against changing an animal's isoId, and it is generally considered to be more stable than the EID.
breed	string	Sire breed name. Learn more about VAS Developer API Cow Breeds.
studCode	integer	Semen company identification. For a listing of standard identifiers for the US, see NAAB Stud Codes.

bullPenDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of when the animal was moved into the bull pen to be bred. Learn more about VAS Developer API Date/Time Formatting.

conceptionDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal conception date. Learn more about VAS Developer API Date/Time Formatting.

conceptionSire data

The conceptionSire is the bull whose semen was used to conceive the current pregnancy.

Data Point	Data Type	Definition
sireDefault	integer	Dairy-specific sire identifier
sireName	string	Sire name
isoId	string	15-digit ISO number associated with the animal eartag, often the same as the electronicID. If the electronicID changes, the isoId does not. The isoId is a unique on-farm animal identifier. VAS recommends against changing an animal's isoId, and it is generally considered to be more stable than the EID.
breed	string	Sire breed name. Learn more about VAS Developer API Cow Breeds.
studCode	integer	Semen company identification. For a listing of standard identifiers for the US, see NAAB Stud Codes.

cowName

string

Cow name

cowNumber

integer

Number assigned to an animal, usually visible on the eartag:

This number is commonly reused and is not unique to the animal on farm or in the VAS suite of products. cowNumber differs from the animal's dairyCowId, EID, and isoId.

displayCowNumber

string

Number used to identify an animal in VAS PULSE Platform:

This number often differs from the animal's id, and may differ from the cowNumber used in DairyComp and other VAS products.

daysCarriedCalf

integer

Number of days from conception date to today

daysDry

integer

Number of days since dryDate event

daysInMilk

integer

Number of days into current lactation. For dry cows, total days in most recent lactation prior to being dried off.

daysOpen

integer

Number of days open (not pregnant)

daysSinceLastHeat

integer

Number of days since last heat in current lactation

disposalCode

string

Reason that an animal left the herd (configurable by dairy in PULSE and/or DairyComp 305)

dryDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of when the cow was removed from milk production in the associated lactation number. Learn more about VAS Developer API Date/Time Formatting.

damNumber

integer

A dam is the female parent of an animal. damNumber is the cowNumber assigned to the animal's dam.

damRegistrationId

string

A dam is the female parent of an animal. damRegistrationId is the 15-digit ISO number associated with the animal's dam.

electronicId

string

15-digit electronic ID Identifier (EID) number associated with the electronic animal eartag, often the same as the IsoId. The EID of an animal changes whenever the button in the electronic tag is replaced:

The EID is subject to change and is therefore not an ideal source for unique animal identification data.

enrollmentDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of when animal was added to the dairy. Learn more about VAS Developer API Date/Time Formatting.

freshDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of fresh event (calving) for the current lactation. Learn more about VAS Developer API Date/Time Formatting.

heatDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of last bred event in the current lactation. Learn more about VAS Developer API Date/Time Formatting.

hospitalDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal's last hospital pen visit. Learn more about VAS Developer API Date/Time Formatting.

isoId

string

15-digit ISO number associated with the animal eartag, often the same as the electronicID. If the electronicID changes, the isoId does not.

The isoId is a unique on-farm animal identifier. VAS recommends against changing an animal's isoId, and it is generally considered to be more stable than the EID.

penNumber

integer

Pen number

lactation

integer

Current lactation number

lastTreatmentDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal's last medical treatment. Learn more about VAS Developer API Date/Time Formatting.

matureEquivalentMilk

integer

Expected/calculated milk production at 305 days in milk with a mature equivalency to the rest of the herd and region based on breed, birth date, and fresh date

milkWithdrawalDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the milk withdrawal period end. Starting at this date-time, the milk is cleared for production. Learn more about VAS Developer API Date/Time Formatting.

penNumber

integer

Current pen number

pregOpenDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal's last open event, which confirms the animal as not pregnant. Learn more about VAS Developer API Date/Time Formatting.

previousConceptionDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the conception date of the animal's last pregnancy. Learn more about VAS Developer API Date/Time Formatting.

previousPenNumber

integer

Pen number prior to current penNumber to indicate the last pen change

projectedCalving

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of expected calving for pregnant animals. Learn more about VAS Developer API Date/Time Formatting.

recheckDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of the animal's latest recheck event, which consists of a vet or other staff checking on the animal as part of a medical treatment. Learn more about VAS Developer API Date/Time Formatting.

relativeValue

integer

Percentage of the animal's mature equivalent (ME) with the herd average

reproductionCode

integer

Reproduction code:

0: HEIFER - female, heifer
1: DNB Do Not Breed - Do not breed
2: FRESH - Fresh cow
3: OK/OPEN - OK to breed
4: BRED - Bred (by AI artificial insemination or bull)
5: PREG Pregnant - Pregnant animal
6: DRY - Dry animal
7: SLD/DIE - Sold or died animal
8: MALE - Male animal

Sire data

A sire is the male parent of an animal.

Data Point	Data Type	Definition
sireDefault	integer	Dairy-specific sire identifier
sireName	string	Sire name
isoId	string	15-digit ISO number associated with the animal eartag, often the same as the electronicID. If the electronicID changes, the isoId does not. The isoId is a unique on-farm animal identifier. VAS recommends against changing an animal's isoId, and it is generally considered to be more stable than the EID.
breed	string	Sire breed name. Learn more about VAS Developer API Cow Breeds.
studCode	integer	Semen company identification. For a listing of standard identifiers for the US, see NAAB Stud Codes.

timesBred

integer

Number of times inseminated during current lactation

totalFat

integer

Total fat produced in current lactation (in weight)

totalMilk

integer

Total milk produced in current lactation (in weight)

totalProtein

integer

Total protein produced in current lactation (in weight)

totalSickDays

integer

Total number of days in hospital pen

vetCode

integer

Code selected by the veterinarian (configurable by dairy in PULSE and/or DairyComp 305)

isMale

boolean

Identifies the animal as male

isAlive

boolean

Identifies the animal as alive

Pen data

Data Point	Data Type	Definition
id	integer	VAS-specific pen identifier
penNumber	integer	Current pen number
zoneId	integer	Dairy zone to which the pen belongs
penType	integer	Reserved for future use
capacity	integer	Maximum number of animals the pen is equipped to contain

soldDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of when the animal was sold. Learn more about VAS Developer API Date/Time Formatting.

deathDate

string

Date/time stamp (YYYY-MM-DDThh:mm:ss in 24-hour UTC time) of when the animal died. Learn more about VAS Developer API Date/Time Formatting.

herdStatus

integer

Status of the herd:

0: alive/active
10: sold
20: died

hasMilkWitholding

boolean

Identifies the animal as having a milk withhold in place

hasBeefWitholding

boolean

Identifies the animal as having a meat withhold in place

note

string

Permanent note

speciesType

integer

Animal species:

1: Cow

HTTP Status Codes & Errors

Status Code/Error	Description
`200 OK`	Standard response for a successful HTTP request.
`201 Created`	A method successfully created a resource.
`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: Check the request for any typos. Check the syntax of the request and verify the parameters provided fall within the expected range. For POST endpoints, verify that the request adheres to the logic of the VAS Developer API: Events may only be added to an animal's current lactation. Events cannot be added to animals in a sold/died status. 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.