> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drug Equivalents

> Find approved products with the same ingredients, their equivalence ratings, and exclusivity and patent dates.

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

**brand\_name** `string`

Brand to resolve to its full ingredient names. 2 to 100 characters.

**ingredients** `string[]`

Active ingredient names, each matched as a whole-word phrase.

**include\_discontinued** `boolean`

Include discontinued products. Defaults to `false`.

<Snippet file="audit-context-params.mdx" />

## Response (200 OK)

Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.

**data.request\_id** `string`

Durable job ID for audit and lookup

**data.status** `string`

Job status: `completed`

**data.tool** `string`

Always `product_drug_equivalents`

**data.result** `object`

The answer, described under Result below

**data.evidence** `object`

Where the answer came from and when

**data.evidence.source** `string`

The public body the data comes from. Always `US Food and Drug Administration`.

**data.evidence.source\_kind** `string`

`public` when the data comes from a public body, `commercial` otherwise

**data.evidence.retrieved\_at** `string`

When the lookup was made, as an ISO 8601 UTC time

**data.evidence.as\_of** `string | null`

When the source says the fact was last updated, or `null` when the source gives no date

## Result

Nested under `data.result`.

**data.result.found** `boolean`

Found.

**data.result.matched\_brand** `string | null`

Matched brand. `null` when the source gives no value.

**data.result.ingredients** `string[]`

Ingredients.

**data.result.total\_records** `number`

Total records.

**data.result.truncated** `boolean`

Truncated.

**data.result.groups** `object[]`

Groups.

**data.result.groups\[].strength** `string`

Strength.

**data.result.groups\[].dosage\_form** `string | null`

Dosage form. `null` when the source gives no value.

**data.result.groups\[].route** `string | null`

Route. `null` when the source gives no value.

**data.result.groups\[].reference\_drug** `object | null`

Reference drug. `null` when the source gives no value.

**data.result.groups\[].reference\_drug.brand\_name** `string | null`

Brand name. `null` when the source gives no value.

**data.result.groups\[].reference\_drug.applicant** `string | null`

Applicant. `null` when the source gives no value.

**data.result.groups\[].reference\_drug.application\_number** `string | null`

Application number. `null` when the source gives no value.

**data.result.groups\[].reference\_drug.product\_number** `string | null`

Product number. `null` when the source gives no value.

**data.result.groups\[].products** `object[]`

Products.

**data.result.groups\[].products\[].brand\_name** `string | null`

Brand name. `null` when the source gives no value.

**data.result.groups\[].products\[].applicant** `string | null`

Applicant. `null` when the source gives no value.

**data.result.groups\[].products\[].application\_number** `string | null`

Application number. `null` when the source gives no value.

**data.result.groups\[].products\[].product\_number** `string | null`

Product number. `null` when the source gives no value.

**data.result.groups\[].products\[].te\_codes** `string[]`

Te codes.

**data.result.groups\[].products\[].reference\_listed\_drug** `boolean`

Reference listed drug.

**data.result.groups\[].products\[].reference\_standard** `boolean`

Reference standard.

**data.result.groups\[].products\[].marketing\_status** `string | null`

Marketing status. `null` when the source gives no value.

**data.result.groups\[].products\[].approval\_date** `string | null`

Approval date. `null` when the source gives no value.

**data.result.groups\[].products\[].exclusivity** `object[]`

Exclusivity.

**data.result.groups\[].products\[].exclusivity\[].code** `string | null`

Code. `null` when the source gives no value.

**data.result.groups\[].products\[].exclusivity\[].expires** `string | null`

Expires. `null` when the source gives no value.

**data.result.groups\[].products\[].patents** `object[]`

Patents.

**data.result.groups\[].products\[].patents\[].number** `string | null`

Number. `null` when the source gives no value.

**data.result.groups\[].products\[].patents\[].expires** `string | null`

Expires. `null` when the source gives no value.

**data.result.groups\[].products\[].patents\[].drug\_substance** `boolean`

Drug substance.

**data.result.groups\[].products\[].patents\[].drug\_product** `boolean`

Drug product.

**data.result.groups\[].products\[].patents\[].use\_code** `string | null`

Use code. `null` when the source gives no value.

```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/product-drug-equivalents \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "ingredients": [
      "apixaban"
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/product-drug-equivalents", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "ingredients": [
      "apixaban"
    ]
  }),
});
```

```typescript SDK theme={null}
const result = await agent.tool('lookup/product-drug-equivalents', {
  ingredients: [
    'apixaban'
  ]
});
console.log(result.result);
console.log(result.evidence);
```

```json Response (200) theme={null}
{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "product_drug_equivalents",
    "result": {
      "found": true,
      "matched_brand": null,
      "ingredients": [
        "apixaban"
      ],
      "total_records": 30,
      "truncated": false,
      "groups": [
        {
          "strength": "APIXABAN 0.15MG",
          "dosage_form": "FOR SUSPENSION",
          "route": "ORAL",
          "reference_drug": {
            "brand_name": "ELIQUIS SPRINKLE",
            "applicant": "BRISTOL MYERS SQUIBB CO",
            "application_number": "N220073",
            "product_number": "001"
          },
          "products": [
            {
              "brand_name": "ELIQUIS SPRINKLE",
              "applicant": "BRISTOL MYERS SQUIBB CO",
              "application_number": "N220073",
              "product_number": "001",
              "te_codes": [],
              "reference_listed_drug": true,
              "reference_standard": true,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2025-04-17",
              "exclusivity": [
                {
                  "code": "NP",
                  "expires": "2028-04-17"
                },
                {
                  "code": "PED",
                  "expires": "2028-10-17"
                }
              ],
              "patents": [
                {
                  "number": "11896586",
                  "expires": "2040-11-22",
                  "drug_substance": false,
                  "drug_product": true,
                  "use_code": "U-4180"
                },
                {
                  "number": "11896586*PED",
                  "expires": "2041-05-22",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                },
                {
                  "number": "6967208",
                  "expires": "2026-11-21",
                  "drug_substance": true,
                  "drug_product": true,
                  "use_code": "U-4180"
                },
                {
                  "number": "6967208*PED",
                  "expires": "2027-05-21",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                }
              ]
            }
          ]
        },
        {
          "strength": "APIXABAN 2.5MG",
          "dosage_form": "TABLET",
          "route": "ORAL",
          "reference_drug": {
            "brand_name": "ELIQUIS",
            "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
            "application_number": "N202155",
            "product_number": "001"
          },
          "products": [
            {
              "brand_name": "ELIQUIS",
              "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
              "application_number": "N202155",
              "product_number": "001",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": true,
              "reference_standard": false,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2012-12-28",
              "exclusivity": [
                {
                  "code": "NPP",
                  "expires": "2028-04-17"
                },
                {
                  "code": "PED",
                  "expires": "2028-10-17"
                }
              ],
              "patents": [
                {
                  "number": "6967208",
                  "expires": "2026-11-21",
                  "drug_substance": true,
                  "drug_product": true,
                  "use_code": "U-1729"
                },
                {
                  "number": "6967208*PED",
                  "expires": "2027-05-21",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                },
                {
                  "number": "9326945",
                  "expires": "2031-02-24",
                  "drug_substance": false,
                  "drug_product": true,
                  "use_code": null
                },
                {
                  "number": "9326945*PED",
                  "expires": "2031-08-24",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                }
              ]
            },
            {
              "brand_name": "APIXABAN",
              "applicant": "REGCON HOLDINGS LLC",
              "application_number": "A209898",
              "product_number": "001",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": false,
              "reference_standard": false,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2020-09-11",
              "exclusivity": [],
              "patents": []
            },
            {
              "brand_name": "APIXABAN",
              "applicant": "ACCORD HEALTHCARE INC",
              "application_number": "A210180",
              "product_number": "001",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": false,
              "reference_standard": false,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2020-07-28",
              "exclusivity": [],
              "patents": []
            }
          ]
        },
        {
          "strength": "APIXABAN 5MG",
          "dosage_form": "TABLET",
          "route": "ORAL",
          "reference_drug": {
            "brand_name": "ELIQUIS",
            "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
            "application_number": "N202155",
            "product_number": "002"
          },
          "products": [
            {
              "brand_name": "ELIQUIS",
              "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
              "application_number": "N202155",
              "product_number": "002",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": true,
              "reference_standard": true,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2012-12-28",
              "exclusivity": [
                {
                  "code": "NPP",
                  "expires": "2028-04-17"
                },
                {
                  "code": "PED",
                  "expires": "2028-10-17"
                }
              ],
              "patents": [
                {
                  "number": "6967208",
                  "expires": "2026-11-21",
                  "drug_substance": true,
                  "drug_product": true,
                  "use_code": "U-1200"
                },
                {
                  "number": "6967208*PED",
                  "expires": "2027-05-21",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                },
                {
                  "number": "9326945",
                  "expires": "2031-02-24",
                  "drug_substance": false,
                  "drug_product": true,
                  "use_code": null
                },
                {
                  "number": "9326945*PED",
                  "expires": "2031-08-24",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                }
              ]
            },
            {
              "brand_name": "APIXABAN",
              "applicant": "REGCON HOLDINGS LLC",
              "application_number": "A209898",
              "product_number": "002",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": false,
              "reference_standard": false,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2020-09-11",
              "exclusivity": [],
              "patents": []
            },
            {
              "brand_name": "APIXABAN",
              "applicant": "ACCORD HEALTHCARE INC",
              "application_number": "A210180",
              "product_number": "002",
              "te_codes": [
                "AB"
              ],
              "reference_listed_drug": false,
              "reference_standard": false,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2020-07-28",
              "exclusivity": [],
              "patents": []
            }
          ]
        },
        {
          "strength": "APIXABAN 0.5MG",
          "dosage_form": "TABLET, FOR SUSPENSION",
          "route": "ORAL",
          "reference_drug": {
            "brand_name": "ELIQUIS",
            "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
            "application_number": "N202155",
            "product_number": "003"
          },
          "products": [
            {
              "brand_name": "ELIQUIS",
              "applicant": "BRISTOL MYERS SQUIBB CO PHARMACEUTICAL RESEARCH INSTITUTE",
              "application_number": "N202155",
              "product_number": "003",
              "te_codes": [],
              "reference_listed_drug": true,
              "reference_standard": true,
              "marketing_status": "HUMAN PRESCRIPTION DRUG",
              "approval_date": "2025-04-17",
              "exclusivity": [
                {
                  "code": "NS",
                  "expires": "2028-04-17"
                },
                {
                  "code": "PED",
                  "expires": "2028-10-17"
                }
              ],
              "patents": [
                {
                  "number": "6967208",
                  "expires": "2026-11-21",
                  "drug_substance": true,
                  "drug_product": true,
                  "use_code": "U-4179"
                },
                {
                  "number": "6967208*PED",
                  "expires": "2027-05-21",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                },
                {
                  "number": "9326945",
                  "expires": "2031-02-24",
                  "drug_substance": false,
                  "drug_product": true,
                  "use_code": null
                },
                {
                  "number": "9326945*PED",
                  "expires": "2031-08-24",
                  "drug_substance": false,
                  "drug_product": false,
                  "use_code": null
                }
              ]
            }
          ]
        }
      ]
    },
    "evidence": {
      "source": "US Food and Drug Administration",
      "source_kind": "public",
      "retrieved_at": "2026-10-28T20:34:17.853Z",
      "calls": [
        {
          "retrieved_at": "2026-10-28T20:34:17.853Z"
        }
      ],
      "as_of": "2026-10-28"
    }
  }
}
```

> [!NOTE]
>
> See [Pricing](https://docs.oneshotagent.com/pricing.md) 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}`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.