calves Endpoint

The calves endpoint provides data on a dairy's calves, including the following:

Animals 90 days old or younger as of today, based on the animal's birthDate
All animals, female or male

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.

https://platform-vendor-api.vas.com/dairies/{dairyId}/animals/calves
PATH PARAMETERS
{dairyId}* integer	VAS-specific A data value that originates from the VAS product line. dairy identifier
* Required
QUERY PARAMETERS
sinceDate string	Start date for which to include results (YYYY-MM-DD). If no parameter is defined, all results are returned. This parameter queries the date the calf was entered into the VAS system, `createdAt`, which may differ from the animal's `birthDate`.
includeAnimalsInState string	Animals to include: 0: active 10: sold 20: dead You can use the numeric and text values interchangeably in requests. For example, the two query parameters below are identical: ?includeAnimalsInState=10&includeAnimalsInState=20 ?includeAnimalsInState=sold&includeAnimalsInState=dead If no parameter is defined, active animal results are returned.

Sample Response (JSON)

{
    "items": [
        {
            "id": 101123,
            "cowNumber": 21399,
			"cowName": "Bertha",
			"isoId": "US003148283123",
            "birthDate": "2019-08-19T05:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "US003148283123",
            "damNumber": 1,
            "sireIsoId": "840003132117123",
            "twinCode": "E",
            "lactation": 0,
            "reproductionCode": 0
        },
        {
            "id": 101234,
            "cowNumber": 21400,
			"cowName": "Sue",
            "isoId": "US003148283234",
            "birthDate": "2019-08-04T02:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "US003148283234",
            "damNumber": 17099,
            "sireIsoId": "840003013614234",
            "twinCode": "T"
			"lactation": 0,
			"reproductionCode": 0
        },
        {
            "id": 101567,
            "cowNumber": 21401,
            "cowName": "Bessie",
			"isoId": "US003148283567",
            "birthDate": "2019-07-13T01:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "US003148283567",
            "damNumber": 18300,
            "sireIsoId": "840003130915567",
            "twinCode": "E"
			"lactation": 0,
			"reproductionCode": 0
        },
        {
            "id": 101678,
			"cowNumber": 21402,
            "cowName": "Samantha",
            "isoId": "-",
            "birthDate": "2019-08-19T05:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "-",
            "damNumber": 17025,
            "sireIsoId": "840000069981678",
            "twinCode": "-"
			"lactation": 0,
			"reproductionCode": 0
        }
    ]
}

Sample Response (JSON)

{
    "items": [
        {
            "id": 101123,
            "cowNumber": 21399,
            "cowName": "Bertha",
            "isoId": "US003148283123",
            "birthDate": "2019-08-19T05:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "US003148283123",
            "damNumber": 1,
            "sireIsoId": "840003132117123",
	     "twinCode": "E", 
	     "lactation": 0,
	     "reproductionCode": 0
        },
        {
            "id": 101678,
            "cowNumber": 21402,
            "cowName": "Samantha",
            "isoId": "-",
            "birthDate": "2019-08-19T05:00:00+00:00",
            "breed": "H",
            "isMale": false,
            "electronicId": "-",
            "damNumber": 17025,
            "sireIsoId": "840000069981678",
            "twinCode": "-"
	     "lactation": 0,
	     "reproductionCode": 0
        }
    ]
}

Response Schema

Data Point	Data Type	Definition
id	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.
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.
cowName	string	Cow 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.
birthDate	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 the calf's birth date. This date determines whether an animal is a calf. Calves are animals 90 days old or younger (based on today's date). Learn more about VAS Developer API Date/Time Formatting.
breed	string	Breed name abbreviation. Learn more about VAS Developer API Cow Breeds.
isMale	boolean	Identifies the animal as male (bull calf)
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.
damNumber	string	Calf dam's cowNumber
sireIsoId	string	Calf sire's IsoId
twinCode	string	Calf twin/embryo transfer information, provided by the FRESH event: T: Calf is a twin E: Calf is the result of an embryo transfer - (hyphen): Blank
lactation	integer	Current lactation number
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

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.

< Return to ANIMALS Resource