Skip to main content
POST
Returns the US Food and Drug Administration’s therapeutic equivalence ratings from the Orange Book for a drug, by brand name or active ingredients: every approved product with the same ingredients, grouped by strength, dosage form and route, with its equivalence code, reference drug, marketing status, and exclusivity and patent expiry dates. Not medical or legal advice.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
Brand to resolve to its full ingredient names. 2 to 100 characters.
string[]
Active ingredient names, each matched as a whole-word phrase.
boolean
Include discontinued products. Defaults to false.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always product_drug_equivalents
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US Food and Drug Administration.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
boolean
Found.
string | null
Matched brand. null when the source gives no value.
string[]
Ingredients.
number
Total records.
boolean
Truncated.
object[]
Groups.
string
Strength.
string | null
Dosage form. null when the source gives no value.
string | null
Route. null when the source gives no value.
object | null
Reference drug. null when the source gives no value.
string | null
Brand name. null when the source gives no value.
string | null
Applicant. null when the source gives no value.
string | null
Application number. null when the source gives no value.
string | null
Product number. null when the source gives no value.
object[]
Products.
string | null
Brand name. null when the source gives no value.
string | null
Applicant. null when the source gives no value.
string | null
Application number. null when the source gives no value.
string | null
Product number. null when the source gives no value.
string[]
Te codes.
boolean
Reference listed drug.
boolean
Reference standard.
string | null
Marketing status. null when the source gives no value.
string | null
Approval date. null when the source gives no value.
object[]
Exclusivity.
string | null
Code. null when the source gives no value.
string | null
Expires. null when the source gives no value.
object[]
Patents.
string | null
Number. null when the source gives no value.
string | null
Expires. null when the source gives no value.
boolean
Drug substance.
boolean
Drug product.
string | null
Use code. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • A code starting with A rates equivalence to others in its group with the same code (AB1 only to AB1). B means not rated equivalent. Empty codes mean no rating, including single-source or discontinued products.
  • Exclusivity and patent codes such as PED, NCE and PC are the Orange Book’s own and are not explained here.
  • A brand resolves to full ingredient names; all brands and generics with those ingredients are returned, including other dosage forms. Discontinued products are excluded unless asked.
  • For the product’s label use Drug Label. The source refreshes monthly; truncated indicates more records than the source returned.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}