/v1/pills/searchFind tablets and capsules by imprint, color, shape and other markings.
AuthorizationstringRequiredBearer token with your API key. Keep the key server-side.
Idempotency-KeystringOptionalMakes a retry count once. 8 to 128 letters, digits and . _ : / + -, starting with a letter or digit. For 24 hours the key is bound to your workspace and the exact request; reusing it for different work is refused with 409.
Send the fields as a JSON body.
imprintstringRequiredat most 200 charactersBoth sides, any order. The printed letters and numbers. Matching ignores case, spaces and punctuation.
colorsarray of stringOptionalat most 3 itemsUp to three FDA pill colors, such as white or blue. Every color you send must be recorded for the pill. A pill with no recorded color matches no color filter. Common words like off-white are accepted. Other values return 400 with the accepted list.
shapestringOptionalat most 60 charactersAn FDA pill shape, such as round, oval or capsule. A pill with no recorded shape matches no shape filter. Common words like oblong are accepted. Other values return 400 with the accepted list.
dosage_formstringOptionalat most 60 charactersDosage form. Tablet or capsule also matches its extended- and delayed-release forms.
scoredbooleanOptionalWhether the pill is scored. Pills with unknown scoring match neither value.
limitintegerOptionalDefaults to 20min 1 · max 100The most candidates to return, from 1 to 100; defaults to 20. Candidates come in a fixed order that is not a confidence score.
cursorstringOptionalat most 4096 charactersThe next-page cursor from the preceding response, with the same filters.
A list of PillMatch objects, one per result; page metadata is in meta. Optional fields are left out when empty; a few return null for unknown, as their sentences say. Dates are YYYY-MM-DD and times ISO 8601 UTC.
drugstringRequiredThe drug name, such as hydrocodone bitartrate and acetaminophen.
strengthstringOptionalStrength; absent when unknown.
dosage_formstringOptionalDosage form; absent when unknown.
imprintstringRequiredThe imprint from the label, with its printed parts separated by semicolons.
colorsarray of stringRequiredThe pill’s colors.
shapestringOptionalThe pill’s shape; absent when unknown.
scoredbooleanOptionalWhether the pill is scored; absent when the label does not say.
discontinuedbooleanOptionalTrue when the SPL marketing dates record every product behind this pill as ended, false when any is recorded as marketed; absent when unknown. It does not say whether the pill can still be bought.
companiesarray of PillCompanyRequiredThe companies that label this pill.
labelsarray of PillLabelRequiredThe DailyMed labels that carry this pill.
Errors and limits lists every code and the limits behind them.