Solution
Insurers (incl. Medicaid managed care)
Care-gap identification and rising-risk members across covered lives.
- Credential model
- OAuth 2.0 client credentials for your organisation. Authentication
- Before production
- Validation evidence on your population, and a BAA.
- Sandbox
- Ask for the sandbox kind that fits your organisation.
Families you'll use
| Family | Fit | Status |
|---|---|---|
| Claims in | Core | Built — gated |
| Population | Core | Built — gated |
| Social needs & programmes | Core | Built — gated |
| Data in | Useful | Built — gated |
| Enrolment & messaging | Useful | Built — gated |
| Enrolment roster | Useful | Built — gated |
Scopes to request
Ask only for what your product uses.
| Scope | Allows |
|---|---|
population.aggregate.read | Read aggregate counts for your whole active panel (worklist tiers, rising risk, care gaps); every count below the small-cell minimum is suppressed, no ids (medical practices only). |
population.measures.read | Read five eCQM-style quality measures and the Million Hearts ABCS as suppressed rates; NOT a certified eCQM calculation (medical practices only). |
population.export | Run asynchronous FHIR Bulk Data exports of your panel, identified (each patient's sharing choices apply) or HIPAA Safe Harbor de-identified; audited per file (medical practices only). |
population.measures.export | Download the QRDA Category III file for the 2026 period: TRUE counts, not submission-validated, audited and refused when the audit log is down (medical practices only). |
claims.import.write | Send claims files (CMS CCLF Part A / B / D, or your plan's claims as CSV / NDJSON in the documented shape): staged with a dry run (match rate, row errors by code), then committed or discarded. MBIs and plan member ids are fingerprinted and never stored (treating practices and programme organisations with a BAA on file). |
claims.read | Read a member's claims summary (counts by part and setting, dates, top diagnosis categories, CMS-HCC categories only when an official model is loaded) from your imported claims and, when the member shares their medical history with you, their own Medicare Blue Button summary; and whether they connected Blue Button or VA records (read-only). |
claims.risk_adjustment.read | Read risk-adjustment audit evidence for a member: the diagnosis codes in the claims you imported with the dated claims documenting each, grouped into CMS-HCC categories only when an official model is loaded; never a risk score (treating practices and programme organisations with a BAA on file). |
social_needs.read | Read a patient's health-related social needs screen (AHC-HRSN core) with the positive domains coded to ICD-10-CM Z-codes and SNOMED CT as Norvya asserts them, and the closed-loop community referrals your practice made, with Gravity-aligned Task status (treating practices only; the patient must share their medical history with you; a positive interpersonal-safety screen never leaves Norvya). |
social_needs.write | Ask a patient to complete a social needs screen (Norvya's generic push), and create and update closed-loop referrals to community organisations (treating practices only). |
programs.community_care.read | Read the VA Community Care, IHS Purchased/Referred Care and TRICARE referrals and authorisations your practice recorded in Norvya, with authorised dates, visits used and documentation deadlines; Norvya never authorises care or determines eligibility (treating practices only). |
members.roster.write | Upload a roster of your eligible members (CSV / NDJSON, or a CMS eligibility / attribution file), review its dry run, then have Norvya invite them in bulk (its own email in each person's language; daily cap, queued not dropped), send reminders and collect phone-only join links. MBIs never stored raw (medical practices / programmes with a BAA only). |
members.roster.read | Read your rosters and their enrolment report: invited, opened, joined, expired, revoked and declined as small-cell-suppressed counts by cohort, plus the status of each of your roster rows (medical practices / programmes only). |
Not callable yet
- Data in Built — gated
- Enrolment & messaging Built — gated
Before production
Gate: Validation evidence on your population, and a BAA.
Sandbox
Build and test against synthetic members before you touch real data. Ask for the sandbox kind that fits your organisation. What a sandbox holds, its credentials, limits, resets and expiry are in the Sandbox guide. To request one, write to [email protected] with your organisation and market.
Every endpoint for this market
The families this solution uses, filtered to the scopes it requests. Each link opens the endpoint on its family page.
Platform Built — gated2
- POST
/v1/oauth/token - GET
/v1/usage
Enrolment roster Built — gated9
- GET
/v1/rosters - POST
/v1/rosters - GET
/v1/rosters/{roster_ref} - POST
/v1/rosters/{roster_ref}/commit - POST
/v1/rosters/{roster_ref}/discard - GET
/v1/rosters/{roster_ref}/enrolment - GET
/v1/rosters/{roster_ref}/join-links - POST
/v1/rosters/{roster_ref}/remind - POST
/v1/rosters/{roster_ref}/simulate-joins
Claims in Built — gated7
- POST
/v1/claims/imports - GET
/v1/claims/imports/{claims_import_ref} - POST
/v1/claims/imports/{claims_import_ref}/commit - POST
/v1/claims/imports/{claims_import_ref}/discard - GET
/v1/patients/{member_ref}/claims-summary - GET
/v1/patients/{member_ref}/connections - GET
/v1/patients/{member_ref}/risk-adjustment-evidence
Social needs & programmes Built — gated9
- GET
/v1/community-care/authorizations - GET
/v1/patients/{member_ref}/community-care/authorizations - GET
/v1/patients/{member_ref}/social-needs - POST
/v1/patients/{member_ref}/social-needs/referrals - POST
/v1/patients/{member_ref}/social-needs/screenings - GET
/v1/social-needs/reference - GET
/v1/social-needs/referrals - GET
/v1/social-needs/referrals/{referral_ref} - POST
/v1/social-needs/referrals/{referral_ref}/status
Population Built — gated13
- GET
/v1/population/epsdt - POST
/v1/population/exports - GET
/v1/population/exports/{export_id} - DELETE
/v1/population/exports/{export_id} - GET
/v1/population/exports/{export_id}/files/{name} - GET
/v1/population/hedis - GET
/v1/population/measures - GET
/v1/population/measures/qrda3 - GET
/v1/population/social-needs - GET
/v1/population/summary - GET
/v1/population/uds - GET
/v1/population/uds-plus - GET
/v1/population/uds/export