Which API to use - RCIntel

Use this page to pick a REST family. Parameter-level detail lives in API Reference. Trial keys (kp_test_) call the sandbox host; live keys (kp_live_) call production. Same paths on both — authentication.

Start here

Job	Call	Guide
Cited payer policy (NCD / LCD / MAC / UHC)	`GET /v1/policies`	Payer policies · OpenAPI
Your uploaded manuals / contracts	`POST /v1/policy/parse` then `/structure` — schema in API Reference; `kp_test_` for a live sample	Your policy documents · API Reference
340B manufacturer access	`GET /v1/340b/restrictions/resolve`	340B
Prior auth required?	`GET /v1/prior-auth/check`	Prior authorization
Who is this payer?	`GET /v1/directory/payers/` (public)	Payer network
Full billing context from a CCN	`POST /v1/knowledge/resolve`	Knowledge resolve
Expected Medicare payment	`POST /v1/knowledge/payment-calc` or `GET /v1/fee-schedules/...`	Fee schedules
NCCI units / bundling	`GET /v1/ncci/...`	NCCI
Pre-visit PA + NCCI + payment	`POST /v1/encounter/check`	Encounter check
Coding or appeal research	`POST /v1/agents/...` then poll or `callback_url`	AI agents · Agent callbacks

Policy and coverage

Endpoint	When to use
`GET /v1/policies`	Versioned, geo-scoped cited policy for a payer + code (our posted library)
`GET /v1/policies/changes`	Document-grain policy diffs (pull). Empty until versions exist
`POST /v1/policy/parse`	Chunk your PDF. Does not write the public policy mart
`POST /v1/policy/structure`	Folder tree for a parsed upload (reimbursement, coding, PA, …)
`POST /v1/policy/retrieve`	Rank chunks for a question on your uploads
`GET /v1/340b/manufacturers`	Latest approved 340B manufacturer policy cards
`GET /v1/340b/restrictions/resolve`	Fail-closed access status for an entity / NDC / manufacturer
`GET /v1/340b/changes`	Manufacturer policy change feed
`GET /v1/340b/entities/{id}`	OPAIS covered entity + contract pharmacies
`POST /v1/340b/portfolio/check`	Batch resolve a formulary × sites
`GET /v1/prior-auth/check`	CRD-style PA determination
`GET /v1/prior-auth/documentation/{payer}/{code}`	Documents the payer wants on the PA
`GET /v1/payers/denial-codes/{code}`	CARC and RARC (e.g. `N479`) from the X12 mart
`GET /v1/concepts/umls/search`	UMLS Metathesaurus preferred terms
`GET /v1/concepts/umls/{cui}`	One CUI (e.g. `C0011849`)
`GET /v1/payers/{slug}`	Authenticated payer profile, filing, appeals

Knowledge, codes, and payment

Endpoint	When to use
`POST /v1/knowledge/resolve`	L1–L6 stack from a CCN
`POST /v1/knowledge/billing-guide`	Form, TOB, modifiers
`POST /v1/knowledge/payment-calc`	MPFS-style estimate at a facility
`GET /v1/fee-schedules/mpfs/{code}`	Professional RVUs
`GET /v1/fee-schedules/opps/{code}`	Hospital outpatient APC
`GET /v1/fee-schedules/dme/{code}`	DMEPOS by state
`GET /v1/fee-schedules/lab/{code}`	CLFS
`GET /v1/ncci/validate`	Can these two codes bill together?
`GET /v1/codes/search`	CPT/HCPCS lookup
`GET /v1/npi/search`	NPPES provider search
`GET /v1/drugs/ndc/search`	OpenFDA NDC

Agents (async)

Endpoint	When to use
`POST /v1/agents/code-research`	Which code, documentation, modifiers
`POST /v1/agents/medical-necessity`	NCD/LCD necessity write-up
`POST /v1/agents/denial-resolution`	CARC/RARC + appeal strategy
`GET /v1/agents/jobs/{job_id}`	Poll until `completed` or `failed`

POST /v1/encounter/check is the pre-visit bundle — see Encounter check, not an agent. Pass callback_url + callback_secret on submit instead of polling. See Agent callbacks. Register the facility first (POST /v1/facilities) if the route needs a CCN on your tenant.