API reference
Read-only, FHIR-aligned resources. Each is facility-scoped and requires a specific scope. All responses use the {data, meta, error} envelope.
Base URL & auth
https://medflo-pcc-vendor-api-eez5kqwsxa-uw.a.run.app/api/v1 and requires Authorization: Bearer <token>. Get a token from Authentication.Resources
An outward, read-only view of a resident's demographics and identifiers, mapped to FHIR Patient. Identifier values are returned masked exactly as the system of record returns them — the API never unmasks them.
A resident's payer coverage / policies, mapped to FHIR Coverage — for eligibility, clearinghouse, and HIE partners. Read-only; real-time eligibility (X12 270/271) is surfaced here as coverage status.
A resident's diagnoses / problem list, mapped to FHIR Condition. Codes are ICD-10-CM. Part of the read-only clinical resource set — clinical writes are never exposed on the integration API.
A resident's medication orders, mapped to FHIR MedicationRequest. The drug identity is a First DataBank (FDB) drug id surfaced in the coding system uri — never a PCC/internal drug id.
A resident's allergies, mapped to FHIR AllergyIntolerance. Read-only, part of the clinical resource set.
A resident's vitals, weights, and results, mapped to FHIR Observation. Blood pressure carries systolic/diastolic; single-value vitals carry the value and unit. Read-only.
Common patterns
- List — GET
/…/{collection}returns a paginated array. Use?page=and?page_size=(default 50, max 200). Most lists also accept?resident_id=to filter. - Read — GET
/…/{collection}/{id}returns a single resource. - Pagination lives in
meta.page={ page, page_size, total }.
A sample call
# Call a resource with the bearer token from the token step.
TOKEN="eyJ..." # the access_token from /oauth/token
curl -s 'https://medflo-pcc-vendor-api-eez5kqwsxa-uw.a.run.app/api/v1/ofctx/sandbox-org-0001/sandbox-fac-0001/residents?page_size=5' \
-H "Authorization: Bearer $TOKEN" \
-H 'Accept: application/json'
# → { "data": [ { "resourceType": "Patient", ... } ],
# "meta": { "page": { "page": 1, "page_size": 5, "total": ... } },
# "error": null }