⌘K
Sign upSign in
All guides
Interoperability· 14 min

TEFCA Exchange via KONZA Health

Cross-community patient discovery and document query through Parker Apex's designated QHIN partner, KONZA Health.

  1. 1

    Understand the exchange model

    Parker Apex participates in TEFCA through KONZA Health, a Designated QHIN (December 2023). Outbound queries route to KONZA's network; inbound requests from other QHINs hit Parker's XCPD/XCA endpoints. All outbound patient/resource queries require a Parker GPID.

  2. 2

    Seed KONZA in the network directory

    After KONZA onboarding provides endpoint URLs, set KONZA_* variables in .env and run the idempotent seed script. Partners with status=testing are stored but not listed publicly until go-live (--activate sets status=active).

    bash
    "text">-command-muted italic"># Set KONZA_XCPD_ENDPOINT, KONZA_XCA_QUERY_ENDPOINT, etc. in .env first
python apex/scripts/seed_konza_qhin.py

"text">-command-muted italic"># Tuesday go"text-cyan-300">-live (2026-06-17):
python apex/scripts/seed_konza_qhin.py "text-cyan-300">--activate

"text">-command-muted italic"># Verify (after activate):
"text">-amber-300 font">-semibold">curl "text-cyan-300">-s "https://api.parkerapex.com/tefca/directory?framework=tefca" \
  "text-cyan-300">-H "Accept: application/json" | "text">-amber-300 font">-semibold">jq '.partners[] | select(.name | test("KONZA";"i"))'
  3. 3

    Resolve KONZA in the network directory

    Fetch the public directory and locate KONZA Health to obtain the current organization OID for target_organization_oid.

    bash
    "text">-amber-300 font">-semibold">curl "text-cyan-300">-s "https://api.parkerapex.com/tefca/directory?framework=tefca" \
  "text-cyan-300">-H "Accept: application/json" | "text">-amber-300 font">-semibold">jq '.partners[] | select(.name | test("KONZA";"i"))'
  4. 4

    Obtain TEFCA scopes

    Request OAuth client credentials with tefca.xcpd.read and tefca.xca.read for outbound exchange, or tefca.xcpd.write / tefca.xca.write for inbound handlers.

    bash
    https://developers.parkerapex.com/scopes
  5. 5

    Outbound patient discovery (XCPD)

    Search KONZA's QHIN network for a patient using Parker GPID and optional demographics. Include purpose_of_use (TREAT for treatment).

    bash
    "text">-amber-300 font">-semibold">curl "text-cyan-300">-s "text-cyan-300">-X "text">-amber-300 font">-semibold">POST https://api.parkerapex.com/tefca/xcpd/search \
  "text-cyan-300">-H "Authorization: Bearer YOUR_TOKEN" \
  "text-cyan-300">-H "Content">-Type: application/json" \
  "text-cyan-300">-d '{
    "gpid": "APX-1A2B3C4D",
    "target_organization_oid": "KONZA_OID_FROM_DIRECTORY",
    "demographics": { "family_name": "Smith", "birth_date": "1985-03-15" },
    "purpose_of_use": "TREAT"
  }'
  6. 6

    Outbound document query (XCA)

    Retrieve FHIR resources from KONZA-connected participants. Specify resource_types and GPID.

    bash
    "text">-amber-300 font">-semibold">curl "text-cyan-300">-s "text-cyan-300">-X "text">-amber-300 font">-semibold">POST https://api.parkerapex.com/tefca/xca/search \
  "text-cyan-300">-H "Authorization: Bearer YOUR_TOKEN" \
  "text-cyan-300">-H "Content">-Type: application/json" \
  "text-cyan-300">-d '{
    "gpid": "APX-1A2B3C4D",
    "target_organization_oid": "KONZA_OID_FROM_DIRECTORY",
    "resource_types": ["Patient", "DocumentReference", "DiagnosticReport"],
    "purpose_of_use": "TREAT"
  }'
  7. 7

    Handle inbound QHIN traffic

    External QHINs (including KONZA-routed requests) call POST /tefca/xcpd/discover and POST /tefca/xca/query on Parker's gateway. Verify bearer tokens with tefca.xcpd.write / tefca.xca.write scopes and log all purpose_of_use values for audit.

  8. 8

    Migrate from legacy paths

    Deprecated /tefca/v1/patient-discovery and /tefca/v1/document-query aliases sunset 2026-09-12. Update integrations to the XCPD/XCA paths documented in the OpenAPI spec.

    bash
    https://developers.parkerapex.com/deprecation

Related