Skip to main content
POST
Resolve full knowledge stack

Authorizations

X-API-Key
string
header
required

Body

application/json

Resolve the full L1-L6 knowledge stack for a facility and optional claim.

Two equivalent input shapes (both valid):

  • Single-code (legacy): cpt + optional dx_codes
  • Claim-shaped (locked): lines[] + dx[] — same line object as POST /v1/knowledge/payment-calc/claim

When lines is present it is authoritative; cpt is ignored. dx wins over the legacy dx_codes alias when both are sent.

ccn
string
required

6-digit Medicare Provider Number (CCN)

Pattern: ^\d{6}$
Example:

"170001"

care_setting
string | null

Care setting context

Example:

"outpatient"

cpt
string | null

Single CPT/HCPCS code (legacy). Ignored when lines[] is sent.

Pattern: ^[A-Za-z0-9]{5}$
Example:

"99213"

date_of_service
string | null

YYYY-MM-DD for NCCI versioning

dx
string[]

ICD-10-CM diagnosis codes for the claim (preferred over dx_codes)

dx_codes
string[]

Legacy DX alias. Prefer dx[].

Example:
lines
PaymentClaimLine · object[]

Claim procedure lines (max 25). Same shape as payment-calc/claim.

Maximum array length: 25
payer
string | null

Payer name or identifier

Example:

"Medicare"

place_of_service
string | null

Claim-level POS default (e.g. 11, 22)

Example:

"22"

Response

Complete L1-L6 resolution with optional payment estimate

Full knowledge resolution result across all applicable layers.

layers + payment_estimate stay the single-code view (first line) for existing clients. dx / lines / ncci_* are the locked claim-shaped fields.

ccn
string
required

The queried CCN

layers
LayerData · object[]
required

Resolved L1-L6 layer data

audit_tier
string | null

SENTINEL audit tier (green/yellow/red)

coverage_info
CoverageInfo · object | null

Coverage context if payer was provided

dx
string[]

Normalized claim DX

facility_name
string | null

Resolved facility name

lines
KnowledgeResolveLineResult · object[]

Per-line L5/L6/coverage. Empty when no CPT/lines were sent.

ncci_clean
boolean
default:true
ncci_conflicts
NCCIBatchConflict · object[]
payment_estimate
PaymentEstimate · object | null

Physician RVU estimate for the first line (legacy)