Fee quotes API

Quote a California inpatient stay

Calculate the statutory inpatient hospital maximum from the assigned DRG and discharge-date factors.

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

Price a hospital stay when the DRG is already assigned. This endpoint does not group diagnoses or procedures.

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

admissionDate / dischargeDateRequired

string

Stay dates, YYYY-MM-DD. The discharge date selects the edition.

hospitalProviderNumberRequired

string

Six-digit Medicare provider number, keeping leading zeros.

drgRequired

string

Assigned three-digit DRG.

hospitalType / dischargeTypeRequired

string

Hospital and discharge classification.

coveredInpatientChargesCentsRequired

integer

Covered charges in cents.

deviceReplacementCreditStatus / hasNewTechnology / hasOrganAcquisitionRequired

string / boolean / boolean

Required facts that change the calculation.

actualInpatientDays / hasLeaveOfAbsence / hasCovid19Diagnosis

integer / boolean / boolean | null

Conditional facts; see the OpenAPI contract for when each is required.

Examples

curl 'https://app.mindbill.org/partner/v2/fee-quotes/ca/inpatient' \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "admissionDate": "2025-02-01",
  "dischargeDate": "2025-02-05",
  "hospitalProviderNumber": "050002",
  "drg": "470",
  "hospitalType": "acute",
  "dischargeType": "ordinary",
  "coveredInpatientChargesCents": 5000000,
  "deviceReplacementCreditStatus": "none",
  "hasNewTechnology": false,
  "hasOrganAcquisition": false
}'

curl 'https://app.mindbill.org/partner/v2/fee-quotes/ca/inpatient' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "admissionDate": "2025-02-01",
  "dischargeDate": "2025-02-05",
  "hospitalProviderNumber": "050002",
  "drg": "470",
  "hospitalType": "acute",
  "dischargeType": "ordinary",
  "coveredInpatientChargesCents": 5000000,
  "deviceReplacementCreditStatus": "none",
  "hasNewTechnology": false,
  "hasOrganAcquisition": false
}'

Response

200 OK

{
  "data": {
    "status": "priced",
    "dischargeDate": "2025-02-05",
    "drg": "470",
    "lengthOfStay": 4,
    "baseMaximumCents": 3637856,
    "outlierAllowanceCents": 0,
    "totalMaximumCents": 3637856,
    "sources": [{ "url": "https://www.dir.ca.gov/dwc/FeeSchedules/InpatientHospital_FeeSchedule/2024/9789_23.xlsx" }]
  }
}

FieldTypeDescription

data.statusRequired

string

priced, or an explicit unavailable or review reason without an allowance.

data.totalMaximumCents

integer

Statutory maximum, including any outlier allowance.

data.drgFactors / hospital / sources

object

Calculation factors and dated source files.