Fee quotes API

Quote a dispensed drug

Calculate the California maximum for a simple or repackaged dispensed drug by NDC and date.

POSThttps://app.mindbill.org/partner/v2/fee-quotes/pharmacy

Price pharmacy or physician dispensing. Compounds use the compound endpoint; physician-administered drugs require review here.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: bills:read · Browser: bills:read

IdempotencyNot required

Organization capabilitytreatmentBilling must be enabled

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Request body

FieldTypeDescription

ndcNumberRequired

string

11-digit NDC dispensed.

originalNdcNumber

string

Original labeler NDC; required for repackaged products.

dateOfServiceRequired

string

Actual dispensing date, YYYY-MM-DD.

dispenserRequired

"physician" | "pharmacy"

Who dispensed.

productKindRequired

"simple" | "repackaged" | "compound" | "physician_administered"

Product category.

metricQuantityRequired

string

Total NCPDP metric decimal units (not package count).

usualCustomaryCentsRequired

integer

Usual and customary charge, including dispensing.

noSubstitutionRequired

boolean

Dispense-as-written indicator.

pharmacyNpi / billedCents

string / integer

Required for pharmacy dispensing / billed amount.

Examples

curl 'https://app.mindbill.org/partner/v2/fee-quotes/pharmacy' \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "ndcNumber": "00000000001",
  "dateOfService": "2026-09-16",
  "dispenser": "pharmacy",
  "pharmacyNpi": "1234567893",
  "productKind": "simple",
  "metricQuantity": "30",
  "usualCustomaryCents": 4500,
  "billedCents": 4500,
  "noSubstitution": false
}'

curl 'https://app.mindbill.org/partner/v2/fee-quotes/pharmacy' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "ndcNumber": "00000000001",
  "dateOfService": "2026-09-16",
  "dispenser": "pharmacy",
  "pharmacyNpi": "1234567893",
  "productKind": "simple",
  "metricQuantity": "30",
  "usualCustomaryCents": 4500,
  "billedCents": 4500,
  "noSubstitution": false
}'

Response

200 OK

{
  "data": {
    "status": "matched",
    "maximumCents": 2180,
    "amountCents": 2180,
    "ingredientCostCents": 860,
    "dispensingFeeCents": 1320,
    "rateBasis": "ca_simple_dispensed_drug",
    "paymentStatus": "not_determined",
    "provenance": [{ "id": "synthetic_source" }]
  }
}

FieldTypeDescription

data.statusRequired

"matched" | "requires_review"

Maximum found, or a reason requiring review.

data.maximumCents / amountCents

integer

Regulatory maximum and lesser of maximum and billed.

data.ingredientCostCents / dispensingFeeCents

integer

Components of the maximum.

data.paymentStatus

"not_determined"

A quote never establishes payment.

data.provenance[]Required

object[]

Dated NDC price sources.