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

# Read one FDA databases record

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

## Request

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

Read one FDA database record in full, by the dataset and id that search_openfda returned: a label's key sections (boxed warning, indications, dosage, contraindications, warnings and precautions, adverse reactions, clinical studies, each clipped), an application's products and submission history, a complete response letter's text, an establishment's device listings, a substance's codes, names and structure, or the full facts of any other record. This public FDA data is not validated for clinical decisions; cite the record id and its database.

## Path parameters

- `recordId` string, required

## Query parameters

- `dataset` 'drug_label' | 'drug_approvals' | 'drug_ndc' | 'drug_shortages' | 'drug_adverse_events' | 'drug_recalls' | 'complete_response_letters' | 'device_510k' | 'device_pma' | 'device_classification' | 'device_registrations' | 'device_udi' | 'device_recalls' | 'device_enforcement' | 'device_adverse_events' | 'food_recalls' | 'food_adverse_events' | 'cosmetic_adverse_events' | 'animal_adverse_events' | 'tobacco_problem_reports' | 'substances', required: The dataset the id belongs to.

## 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)