---
title: "Read one LiverTox record"
method: GET
path: "/v1/sources/livertox/records/{recordId}"
tags: ["LiverTox"]
---

# Read one LiverTox record

`GET /v1/sources/livertox/records/{recordId}`

## Request

- Base URL: `https://api.assyro.com`
- URL: `https://api.assyro.com/v1/sources/livertox/records/{recordId}`
- Auth: none declared

Read one LiverTox chapter by its id (the id search_livertox gives, usually the drug name: "Acetaminophen", "Amiodarone"): its last-update date, likelihood score(s) with LiverTox's wording, drug class, trade names, then the full text in LiverTox's order (introduction, background, hepatotoxicity, mechanism of injury, outcome and management, case reports, product information, bibliography). Long chapters are cut to the read budget, bibliography last.

## Path parameters

- `recordId` string, required

## Response `200`

The record and its text.

- ReadResponse
  - `version` unknown, required
  - `source` SourceRef, required
    - `id` string, required
    - `label` string, required
    - `authority` string, required
  - `record` Record, required
    - `id` string, required: The source's own identifier for the record.
    - `title` string, required
    - `url` string, required: The record's page at the source, to verify it.
    - `authority` string, required: Who published the record.
    - `snippet` string, nullable, required: The part of the record that matched; null where the licence allows only a link.
    - `publishedDate` string, nullable, required
    - `version` string, nullable, required: The edition or revision read.
    - `fields` object, nullable, required: The source's own fields; null where the licence allows only a link.
    - `asOf` string, nullable, required: The day Assyro's copy of the source was read (YYYY-MM-DD).
    - `attribution` string: The attribution the source's licence requires, on sources that require one.
  - `text` string, nullable, required
  - `truncated` boolean, required

## Other responses

- `400`: The request is not valid: an unknown parameter or an argument the source refuses.
- `404`: No such source or record.
- `429`: Rate limited; retry after the Retry-After header.
- `503`: The source cannot answer from Assyro's copy right now.

---

[API](https://skmtc.dev/assyro/apis/assyro-public-data-api.md) - [All operations](https://skmtc.dev/assyro/apis/assyro-public-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assyro/apis/assyro-public-data-api/revisions/c861290c9f47?raw)