API Documentation
← All tools
GET/api/v1/regulatory/:id

Regulatory Approvals Record

regulatory-approvalsNo success wrapper

Retrieve ONE harmonised approval by its PUBLIC approval_id (FDA_ORANGE:020610, FDA_PURPLE:BLA125514, EMA:EU/1/20/1528 - copy it verbatim from the approval_id field of a Regulatory Approvals Search record; EMA ids contain slashes and are accepted raw or URL-encoded). Returns the application-level group - applicant_raw, record_url, label_indications, sponsors (direct entities; the full direct->ultimate hierarchy with canonical LEI/ROR ids in sponsors_chain), drugs with ChEMBL ids, indications - plus data.products[]: one entry per strength/form listing carrying the patents, exclusivity entries, TE code, pathway flags (orphan / biosimilar / generic / conditional / accelerated) and next patent/exclusivity expiries. Malformed identifiers return HTTP 400; unknown ids HTTP 404. The old internal _key lookup is no longer supported; for name-based drug lookups prefer regulatory.profile.

When to use it

  • full approval record with patents and exclusivity entries
  • verify pathway flags and linked entities for one approval

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Parameters

Path parameters

ParameterTypeRequiredDescription
id(path)stringYesPublic approval identifier: FDA_ORANGE:020610, FDA_PURPLE:BLA125514 or EMA:EU/1/20/1528. Copy it exactly from the approval_id field of a Regulatory Approvals Search record; never construct, guess or transpose an internal _key.

Query parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/regulatory/{id}"

Response envelope

This endpoint returns an implicit 2xx response - there is no success flag in the body.

{
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

// No "success" flag on this endpoint - any 2xx JSON is a success.

Response shape

Single-object responseAPPROVALS

Payload: data.products — Product Listings (secondary list)

Common row fields

FieldDescription
trade_nameMain display field
strength—
dosage_form—
route—
marketing_status—

Empty results: No record found (HTTP 404)

Fetched by the PUBLIC approval_id (FDA_ORANGE:..., FDA_PURPLE:BLA..., EMA:EU/1/... - exactly as returned in a search record's approval_id); a malformed identifier returns HTTP 400 and an unknown one HTTP 404. data is one application group: application-level fields (source, application_number, record_url, applicant_raw, label_indications) plus sponsors (filtered to DIRECT entities; the ultimate parents live in sponsors_chain), drugs (with chembl_id) and indications. data.products holds the per-strength/form listings (patents, exclusivity, TE code, pathway flags and next expiries live per product) - it renders as an attached list; long arrays (patents, exclusivity) are truncated by the trace formatter.

Catalog version 0.0.0-generated · generated from the API source