List all dosages for an animal | Benchling In Vivo

{
  "data": [
    {
      "id": "dsg_a6ezmy1Nh3FnyFhQpmLQd",
      "name": "Day 1 dose",
      "dosed_at": "2026-09-10T07:26:30.740538Z",
      "comments": "Administered by intraperitoneal injection.",
      "weight_at_dosing": "55",
      "dose": {
        "unit": "mg/kg",
        "value": "3.18",
        "display_unit": "mg/kg",
        "display_value": "3.18"
      },
      "dose_volume": {
        "unit": "ml/kg",
        "value": "15.88",
        "display_unit": "ml/kg",
        "display_value": "15.88"
      },
      "stock": {
        "unit": "mg/ml",
        "value": "22.29",
        "display_unit": "mg/ml",
        "display_value": "22.29"
      },
      "volume": {
        "unit": "µL",
        "value": "36.77",
        "display_unit": "µL",
        "display_value": "36.77"
      },
      "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"
      },
      "measurement": {
        "id": "mst_1pvCuMDGykGj1tPu2aaJ3y",
        "study_id": "sdy_6y9Wop1uArRjD93UiQ5qFy",
        "animal_id": "aml_71H39zdfOc89pNIutQSI22",
        "measured_at": "2026-09-10",
        "calculations": [
          {
            "id": "vbl_1j8yubzA6XuNXPKl7WKFUS",
            "key": "weight",
            "name": "Weight",
            "unit": "g",
            "excluded": false,
            "value": "55",
            "formula": "weight",
            "variables": [
              {
                "id": "vbl_1j8yubzA6XuNXPKl7WKFUS",
                "key": "weight",
                "value": "55",
                "unit": "g"
              }
            ]
          }
        ],
        "created_at": "2026-09-10T07:26:30.696641Z",
        "updated_at": "2026-09-10T07:26:30.696641Z"
      },
      "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"
      },
      "treatment": {
        "id": "tmt_6mEKr2Qui7TmqoIMnOTse8",
        "study_id": "sdy_6y9Wop1uArRjD93UiQ5qFy",
        "type": "concentration",
        "name": "Compound A",
        "label": "Test Treatment Label",
        "dose": {
          "unit": "mg/kg",
          "value": "5",
          "display_unit": "mg/kg",
          "display_value": "5"
        },
        "dose_volume": {
          "unit": "ml/kg",
          "value": "15",
          "display_unit": "ml/kg",
          "display_value": "15"
        },
        "stock": {
          "unit": "mg/ml",
          "value": "10",
          "display_unit": "mg/ml",
          "display_value": "10"
        },
        "volume": {
          "unit": "µL",
          "value": "8",
          "display_unit": "µL",
          "display_value": "8"
        },
        "metadata": {
          "treatment-internal-id": "TREATMENT-1234"
        },
        "external_entity_id": null,
        "created_at": "2026-09-10T07:26:30.708117Z",
        "updated_at": "2026-09-10T07:26:30.708117Z"
      },
      "created_at": "2026-09-10T07:26:30.740623Z",
      "updated_at": "2026-09-10T07:26:30.740623Z"
    }
  ],
  "links": {
    "first": "https://acme-api.invivo.benchling.com/api/public/v1/animals/aml_71H39zdfOc89pNIutQSI22/dosages?page=1",
    "last": "https://acme-api.invivo.benchling.com/api/public/v1/animals/aml_71H39zdfOc89pNIutQSI22/dosages?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/dosages",
    "per_page": 10,
    "to": 1,
    "total": 1
  }
}

Returns a list of the doses administered to 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

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 dosages recorded on this animal.

datalist of objects

The dosages 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