API Documentation
← API overview

Supply Chain

14 endpoints · every section below is generated from the API catalog

GET/api/v1/supply-chain/dmf

Dmf

Available on FreeFull reference →

Returns a list of drug master file (DMF) records. Call it to browse or look up DMF entries. An empty list is a valid result, not an error.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/dmf"
GET/api/v1/supply-chain/dmf/:key

Details

Available on FreeFull reference →

Returns the details of a single drug master file (DMF) identified by its key. Call it when you already have a DMF key and need that record's full details.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/dmf/{key}"
GET/api/v1/supply-chain/ema-gmdp

EMA Gmdp

Available on FreeFull reference →

Returns a list of records from the EMA good manufacturing and distribution practice (GMDP) dataset. Call it to retrieve EMA GMDP entries; the response is a list and an empty result is not an error. Requests are rate limited per day, and exceeding the limit returns an error.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/ema-gmdp"
GET/api/v1/supply-chain/ema-gmdp/:key

Details

Available on FreeFull reference →

Returns the full record for a single EMA good manufacturing and distribution practice (GMDP) entry identified by its key. Call it when you already have a key from a list or search result and need the complete details. Fails with a not-found status if no entry matches the key.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/ema-gmdp/{key}"
GET/api/v1/supply-chain/enforcement

Enforcement

Available on FreeFull reference →

Returns a list of supply-chain enforcement records. Call it to retrieve enforcement actions relevant to regulatory or supply-chain compliance. Requests are rate limited per day; exceeding the limit returns an HTTP 429 error.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/enforcement"
GET/api/v1/supply-chain/enforcement/:key

Details

Available on FreeFull reference →

Returns the full details of a single supply-chain enforcement record identified by its key. Call it when you already have an enforcement key and need the complete record rather than a summary. Fails with a not-found status if no record matches the key.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/enforcement/{key}"
GET/api/v1/supply-chain/establishments

Establishments

Available on FreeFull reference →

Returns a list of establishment records from the supply-chain dataset. Call it to retrieve establishments for display or lookup. Rate-limited per day; exceeding the limit returns an HTTP error.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/establishments"
GET/api/v1/supply-chain/establishments/:key

Details

Available on FreeFull reference →

Returns the full detail record for a single supply-chain establishment identified by its key. Call it when you already have an establishment key and need that establishment's details. Fails with an error status if the key is unknown or the request exceeds the daily rate limit.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/establishments/{key}"
GET/api/v1/supply-chain/facilities/:fei/drilldown

Drilldown

Available on FreeFull reference →

Returns a drilldown view of a single supply-chain facility identified by its FEI. Call it when you already have a facility FEI and need its detailed breakdown. Returns 400 if the FEI is empty, 404 if no facility matches the FEI, and 500 on an internal failure.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
fei(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/facilities/{fei}/drilldown"
GET/api/v1/supply-chain/facilities/globe

Globe

Available on FreeFull reference →

Returns a list of supply-chain facilities with their geographic locations, plus metadata giving the returned count, the total available, and whether the result was truncated. Call it to map or browse facility locations across regions. Invalid query parameters return HTTP 400; other failures return HTTP 500.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
limitintegerNoRange 1-50000; default 20000 (range 1-50000; default 20000)
Range: 1 to 50000

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/facilities/globe"
GET/api/v1/supply-chain/inspections

Inspections

Available on FreeFull reference →

Returns a list of inspection records. Call it to retrieve inspections, for example to review regulatory inspection activity. No parameters are accepted.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/inspections"
GET/api/v1/supply-chain/inspections/:key

Details

Available on FreeFull reference →

Returns the full detail record for a single supply-chain inspection identified by its key. Call it when you already have an inspection key and need its complete details. Fails with a not-found status if no inspection matches the key.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
key(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/inspections/{key}"
GET/api/v1/supply-chain/search

Search

Available on FreeFull reference →

Returns a paginated list of supply-chain records matching a full-text query, with metadata including total item count, total pages, and whether more results exist. Use it to find establishments, sponsors, or related records by keyword and to narrow results by risk class, country, sponsor, mention, exclusion status, or date ranges. Invalid query parameters return 400; an unavailable search capability returns 503; other failures return 500.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
risk_classstringNoRisk classification to filter records by.
countrystringNoCountry to filter records by.
sponsorstringNoSponsor name to filter records by.
mentionstringNoText mention to filter records by.
exclusionbooleanNobooleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
record_date_afterstringNoLower bound on record date, as an ISO date (YYYY-MM-DD).
record_date_beforestringNoUpper bound on record date, as an ISO date (YYYY-MM-DD).
updated_sincestringNoOnly return records updated on or after this date, as an ISO date (YYYY-MM-DD).
sortstringNoDefault record_date (default record_date)
Allowed values: record_date, updated
orderstringNoDefault desc (default desc)
Allowed values: asc, desc
pagenumberNoMin 1; default 1 (min 1; default 1)
Range: 1 to ∞
limitnumberNoRange 1-100; default 20 (range 1-100; default 20)
Range: 1 to 100
qstringYesminimum length 1

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/search?q=your_q"
GET/api/v1/supply-chain/walk

Walk

Available on FreeFull reference →

Traverses the supply-chain graph from one or more starting nodes along the given edge types and returns the reached records plus a boundary and metadata. Call it to explore upstream or downstream relationships (suppliers, customers, dependencies) from known entities. Returns 400 when start or edges is empty or parameters are invalid, and 500 on internal failure.

Rate limit: regulatoryApiCallsPerDay · Free plan: 30/day

Parameters

ParameterTypeRequiredDescription
startstring (comma-separated)Yes[comma-separated list] minimum length 1
edgesstring (comma-separated)Yes[comma-separated list] minimum length 1
directionstringNoDefault out (default out)
Allowed values: out, in, both
min_hopsintegerNoRange 0-64; default 1 (range 0-64; default 1)
Range: 0 to 64
max_hopsintegerNoRange 0-64; default 3 (range 0-64; default 3)
Range: 0 to 64
hydratebooleanNobooleans arrive as strings - send 'true' or 'false'; value is parsed from the raw query string and coerced server-side
limitintegerNoRange 1-50000; default 10000 (range 1-50000; default 10000)
Range: 1 to 50000

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/supply-chain/walk?start=your_start&edges=your_edges"