List all measurements for an animal | Benchling In Vivo

{
  "data": [
    {
      "id": "mst_4PJ4z4eoGa5SXJ1YBJOOe7",
      "measured_at": "2026-09-10",
      "calculations": [
        {
          "id": "vbl_3gmZRjUwil5Vdl8UbjfbPA",
          "key": "tumour_volume",
          "name": "Tumour Volume",
          "unit": "mm³",
          "excluded": false,
          "value": "75",
          "formula": "(width * width * length) / 2",
          "variables": [
            {
              "id": "vbl_XTtIl8Mf8oQSiYAug6AIb",
              "key": "width",
              "value": "5",
              "unit": "mm"
            },
            {
              "id": "vbl_4j4dvB4qot5o117TMINtNW",
              "key": "length",
              "value": "6",
              "unit": "mm"
            }
          ]
        },
        {
          "id": "vbl_3i8oy32jXbFON8Qouzedq0",
          "key": "weight",
          "name": "Weight",
          "unit": "g",
          "excluded": false,
          "value": "55",
          "formula": "weight",
          "variables": [
            {
              "id": "vbl_3i8oy32jXbFON8Qouzedq0",
              "key": "weight",
              "value": "55",
              "unit": "g"
            }
          ]
        }
      ],
      "study": {
        "id": "sdy_6y9Wop1uArRjD93UiQ5qFy",
        "project_id": "pjt_7IrvD7jMtAGvBl4AQUUr3g",
        "name": "Benchling In Vivo",
        "code": "CD-26-445",
        "study_code_id": "sdc_n6vkWmmHoACZ15pTxztHk",
        "type": "internal",
        "status": "in_progress",
        "description": "Efficacy study in a xenograft model.",
        "timezone": "America/Los_Angeles",
        "metadata": {
          "study-internal-id": "STUDY-1234"
        },
        "author": {
          "id": "usr_72aeLmlraBB7Ekzu2zTsMW",
          "name": "Jo Harper",
          "email": "jo.harper@example.com",
          "timezone": "UTC"
        },
        "owner": {
          "id": "usr_5TSgutt2ZHPnKOdYbaNlRo",
          "name": "Sam Ellis",
          "email": "sam.ellis@example.com",
          "timezone": "UTC"
        },
        "started_on": "2026-09-10",
        "tracking_day_base": 0,
        "completed_at": null,
        "canceled_at": null,
        "created_at": "2026-09-10T07:27:34.132511Z",
        "updated_at": "2026-09-10T07:27:34.132511Z"
      },
      "animal": {
        "id": "aml_71H39zdfOc89pNIutQSI22",
        "name": "Animal 1",
        "number": 1,
        "catalog": "A0000001",
        "species": "Mus musculus",
        "strain": "C57BL/6J",
        "sex": "m",
        "dob": "2026-09-09",
        "donor": null,
        "ear": "2R",
        "tag": "T-0041",
        "tail": "1",
        "cage_id": "cge_6uFo3TUYezxtFuImb9kk8K",
        "study_id": "sdy_6y9Wop1uArRjD93UiQ5qFy",
        "study_group_id": "grp_1OEdawZKhmLCf88R4AnCZm",
        "tracking_date": "2026-09-10",
        "disease_induction_date": "2026-09-10",
        "disease_survivor": false,
        "terminated_at": null,
        "terminated_by": null,
        "terminated_reason": null,
        "metadata": {
          "animal-internal-id": "ANIMAL-1234"
        },
        "created_at": "2026-09-10T07:27:10.785238Z",
        "updated_at": "2026-09-10T07:27:10.785238Z"
      },
      "user": {
        "id": "usr_1aK0d7qAQqU5vqrEXkU6oU",
        "name": "Robin Vance",
        "email": "robin.vance@example.com",
        "timezone": "America/Los_Angeles",
        "status": "active",
        "metadata": {
          "user-internal-id": "USER-1234"
        },
        "created_at": "2026-09-10T07:26:30.018301Z",
        "updated_at": "2026-09-10T07:26:30.018301Z"
      },
      "created_at": "2026-09-10T08:07:47.000675Z",
      "updated_at": "2026-09-10T08:07:47.000675Z"
    }
  ],
  "links": {
    "first": "https://acme-api.invivo.benchling.com/api/public/v1/animals/aml_71H39zdfOc89pNIutQSI22/measurements?page=1",
    "last": "https://acme-api.invivo.benchling.com/api/public/v1/animals/aml_71H39zdfOc89pNIutQSI22/measurements?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://acme-api.invivo.benchling.com/api/public/v1/animals/aml_71H39zdfOc89pNIutQSI22/measurements",
    "per_page": 10,
    "to": 1,
    "total": 1
  }
}

Returns a list of the readings taken on an animal.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

animalIdstringRequiredformat: "^aml_[a-zA-Z0-9]{10,22}$"

The unique identifier of the animal.

Query parameters

measured_atdateOptional

Filter measurements to return to those taken on a single date. The date the readings were taken, not the date they were recorded.

perPageintegerOptional1-100Defaults to 10

The number of results to return per page, up to a maximum of 100.

pageintegerOptional>=1Defaults to 1

The page of results to return. The first page is 1.

Response headers

X-RateLimit-LimitintegerOptional

The number of requests permitted in the current rate limit window.

X-RateLimit-RemainingintegerOptional

The number of requests still available in the current rate limit window. When several limits apply, this reflects the per-API-key limit, so a request can be rejected while this value is above zero.

X-RateLimit-ResetintegerOptional

The number of seconds until the current rate limit window resets.

Response

A page of measurements recorded on this animal.

datalist of objects

The measurements on this page of results.

linksobject

Absolute URLs for navigating a paginated collection.

metaobject

Pagination counters describing the returned page of results.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error