Fee quotes API

Screen California PTP and MUE edits

Screen practitioner lines against California-adopted procedure-to-procedure (PTP) and public MUE edits.

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

Check coding edits across a patient, provider, and date of service without pricing. Lines are grouped by opaque patientKey, providerKey, and date.

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

completeDateOfServiceContextRequired

boolean

True only when every service for each patient/provider/date group is included, including services on other bills.

lines[]Required

object[]

1–100 lines: id, code (five characters), units (integer), dateOfService, patientKey, providerKey, and up to four modifiers. Use opaque keys, not names.

Examples

curl 'https://app.mindbill.org/partner/v2/fee-quotes/ca/claim-edits' \
  --header "Authorization: Bearer $MINDBILL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "completeDateOfServiceContext": false,
  "lines": [
    {
      "id": "line-1",
      "code": "97110",
      "units": 4,
      "dateOfService": "2026-07-01",
      "patientKey": "patient-1",
      "providerKey": "provider-1"
    }
  ]
}'

curl 'https://app.mindbill.org/partner/v2/fee-quotes/ca/claim-edits' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example' \
  --header 'Content-Type: application/json' \
  --data '{
  "completeDateOfServiceContext": false,
  "lines": [
    {
      "id": "line-1",
      "code": "97110",
      "units": 4,
      "dateOfService": "2026-07-01",
      "patientKey": "patient-1",
      "providerKey": "provider-1"
    }
  ]
}'

Response

200 OK

{
  "data": {
    "status": "requires_review",
    "scope": "submitted_practitioner_lines",
    "completeDateOfServiceContext": false,
    "findings": [{ "type": "incomplete_date_context", "lineIds": ["line-1"], "message": "Other services on this date may change the result.", "citationUrl": "<adopted edition source URL>" }],
    "limitations": ["Edits cover verified California-adopted editions only."]
  }
}

FieldTypeDescription

data.statusRequired

"evaluated" | "requires_review" | "source_unavailable"

Screening result; never a claim acceptance or payable amount.

data.findings[]Required

object[]

type (ptp, mue, public_mue_unavailable, incomplete_date_context), lineIds, message, citationUrl, and edit details.

data.limitations / provenance

string[] / object

Context limitations and the adopted edition used.