Universal API Implementation Guide
1.1.20 - ci-build

Universal API Implementation Guide - Local Development build (v1.1.20) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Table of Contents

.. 0 Table of Contents
... 1 Home
... 2 Changes
... 3 Combo Therapies
... 4 Copay Eligibility Questions
... 5 Copay Mapping
... 6 Copay Value Sets
... 7 Enrollment
... 8 Enrollment Mapping
... 9 Error Handling
... 10 History
... 11 Message Structure
... 12 Message Submission
... 13 Onboarding
... 14 Products Specifics
... 15 Questionnaire
... 16 Regimen Products
... 17 Release 2024 August 5
... 18 Release 2024 Dec 13
... 19 Release 2024 July
... 20 Release 2024 June 14
... 21 Release 2024 June 28
... 22 Release 2024 May 17
... 23 Release 2024 May 3
... 24 Release 2024 May 31
... 25 Release 2024 Nov 15
... 26 Release 2024 Nov 29
... 27 Release 2024 Oct 11
... 28 Release 2024 Oct 18
... 29 Release 2024 Oct 29
... 30 Release 2024 Oct 4
... 31 Release 2024 Sept 25
... 32 Release 2025 Apr
... 33 Release 2025 Feb 14
... 34 Release 2025 Feb 28
... 35 Release 2025 Jan 31
... 36 Release 2025 Jul 03
... 37 Release 2025 Oct
... 38 Release 2026 APR
... 39 Release 2026 Feb 06
... 40 Release 2026 Jun 12
... 41 Release 2026 Jun 18
... 42 Release 2026 Jun 26
... 43 Release 2026 MAR
... 44 Release 2026 May 01
... 45 Release 2026 May 15
... 46 Release 2026 May 29
... 47 Release 2026 Sep 04
... 48 Release 2026 Sep 18
... 49 Release Q 42025
... 50 Search Conventions
... 51 Services
... 52 Status Update Mapping
... 53 Systematic Queries
... 54 Technical Hints
... 55 Testing
... 56 Updates
... 57 Use Cases
... 58 Validation Rules
... 59 Artifacts Summary
.... 59.1 UAPI CapabilityStatement - Genentech FHIR Server
.... 59.2 ServiceRequestTypeSearch
.... 59.3 External - Alecensa Questionnaire
.... 59.4 External - Cotellic Copay Questionnaire
.... 59.5 External - Cotellic Questionnaire
.... 59.6 External - Herceptin Questionnaire
.... 59.7 External - Lucentis Questionnaire
.... 59.8 UAPI Bundle - AS Enrollment
.... 59.9 UAPI Bundle - Copay Enrollment
.... 59.10 UAPI Bundle - Copay Error Reconciliation
.... 59.11 UAPI Bundle - Copay Management
.... 59.12 UAPI Bundle - Copay Request-Response
.... 59.13 UAPI Bundle - Patient Consent Form Only Enrollment
.... 59.14 UAPI Bundle - Query Message
.... 59.15 UAPI Bundle - Query Response Message
.... 59.16 UAPI Bundle - Query Response Multi Patient Message
.... 59.17 UAPI Bundle - Search Result
.... 59.18 UAPI Bundle - Search Result Patient
.... 59.19 UAPI Bundle - Status Update
.... 59.20 UAPI Condition
.... 59.21 UAPI Consent
.... 59.22 UAPI Coverage
.... 59.23 UAPI CoverageEligibilityRequest
.... 59.24 UAPI CoverageEligibilityResponse
.... 59.25 UAPI MedicationRequest
.... 59.26 UAPI MessageHeader
.... 59.27 UAPI Organization
.... 59.28 UAPI Patient
.... 59.29 UAPI Practitioner
.... 59.30 UAPI Provenance
.... 59.31 UAPI RelatedPerson
.... 59.32 UAPI ServiceRequest
.... 59.33 Exact ContactPoint Extension
.... 59.34 UAPI # of Appeals Allowed
.... 59.35 UAPI Additional Documents Required
.... 59.36 UAPI Appeal Submission Deadline
.... 59.37 UAPI BI - Benefits Summary
.... 59.38 UAPI BI - Billing Instructions
.... 59.39 UAPI BI - Specialty Pharmacy
.... 59.40 UAPI Coverage - Card issuance date
.... 59.41 UAPI Coverage Plan Year
.... 59.42 UAPI Coverage Reference Number
.... 59.43 UAPI CoverageEligibilityRequest Product
.... 59.44 UAPI CoverageEligibilityRequest ServiceRequestType
.... 59.45 UAPI CoverageEligibilityResponse Shipment Method
.... 59.46 UAPI CoverageEligibilityResponse Status
.... 59.47 UAPI Estimated Appeal TAT
.... 59.48 UAPI MedicationRequest Dispense Quantity Detailed Breakdown
.... 59.49 UAPI MedicationRequest Dispenser Instructions
.... 59.50 UAPI MessageHeader Timestamp
.... 59.51 UAPI PCP Referral Effective Date
.... 59.52 UAPI PCP Referral On-file?
.... 59.53 UAPI PCP Referral Recertification Date
.... 59.54 UAPI PCP Referral Required?
.... 59.55 UAPI Peer to Peer Available
.... 59.56 UAPI Practitioner Preferred Contact Method
.... 59.57 UAPI Practitioner Shipment Method
.... 59.58 UAPI PreD Est. TAT
.... 59.59 UAPI Prior Auth Est. TAT
.... 59.60 UAPI Spend Down Frequency
.... 59.61 UAPI Value Set - Benefit Type
.... 59.62 UAPI Value Set - Copay Adjudication Categories
.... 59.63 UAPI Value Set - Copay Insurance Plan Types
.... 59.64 UAPI Value Set - Coverage Outcome
.... 59.65 UAPI Value Set - Insurance Unit
.... 59.66 UAPI Value Set - Organization Type
.... 59.67 UAPI Value Set - PreDetermination
.... 59.68 UAPI Value Set - Prescriber Contact Method
.... 59.69 UAPI Value Set - Prescriber Contact Time
.... 59.70 UAPI Value Set - Product Authorization
.... 59.71 UAPI Value Set - Product JCode
.... 59.72 UAPI Value Set - Product Name
.... 59.73 UAPI Value Set - Product Service
.... 59.74 UAPI Value Set - Regimen Product Name
.... 59.75 UAPI Value Set - Service Request Type
.... 59.76 UAPI Value Set - Shipment Method
.... 59.77 UAPI Value Set - Specialty Pharmacy
.... 59.78 UAPI Value Set - System Event Type
.... 59.79 UAPI Code System - Authorization-Supporting Documents Submission
.... 59.80 UAPI Code System - Benefit Type
.... 59.81 UAPI Code System - Copay Adjudication Category
.... 59.82 UAPI Code System - Copay assigned card type
.... 59.83 UAPI Code System - Copay Benefit Types
.... 59.84 UAPI Code System - Copay Brand ID
.... 59.85 UAPI Code System - Copay Claim Status
.... 59.86 UAPI Code System - Copay Claim Supporting Information Category
.... 59.87 UAPI Code System - Copay CRX enrollment channel
.... 59.88 UAPI Code System - Copay CRX enrollment status
.... 59.89 UAPI Code System - Copay CRX workflow selection
.... 59.90 UAPI Code System - Copay Enrollment Errors
.... 59.91 UAPI Code System - Copay Genentech processing error
.... 59.92 UAPI Code System - Copay Insurance Plan Types
.... 59.93 UAPI Code System - Copay Payment Type
.... 59.94 UAPI Code System - Copay Task input types
.... 59.95 UAPI Code System - Copay Task output types
.... 59.96 UAPI Code System - Copay Who is applying
.... 59.97 UAPI Code System - CoverageEligibilityRequest outcome
.... 59.98 UAPI Code System - Event Type
.... 59.99 UAPI Code System - Insurance Unit
.... 59.100 UAPI Code System - PreDetermination
.... 59.101 UAPI Code System - Prescriber Contact Methods
.... 59.102 UAPI Code System - Prescriber Contact Times
.... 59.103 UAPI Code System - Product JCode
.... 59.104 UAPI Code System - Product Names
.... 59.105 UAPI Code System - Product/Service
.... 59.106 UAPI Code System - Regimen Product Names
.... 59.107 UAPI Code System - Service Request Type
.... 59.108 UAPI Code System - Shipment Methods
.... 59.109 UAPI Code System - Specialty Pharmacy
.... 59.110 as-venclexta-mr
.... 59.111 External - Alecensa QuestionnaireResponse
.... 59.112 External - Herceptin Hylecta QuestionnaireResponse
.... 59.113 External - Medication Request: Actemra Intravenous
.... 59.114 External - Medication Request: Actemra Subcutaneous
.... 59.115 External - Medication Request: Enspryng
.... 59.116 External - Medication Request: Evrysdi
.... 59.117 External - Medication Request: Hemlibra
.... 59.118 External - Medication Request: Itovebi
.... 59.119 External - Medication Request: Lucentis
.... 59.120 External - Medication Request: Lucentis (0.5 mg, alternate frequency)
.... 59.121 External - Medication Request: Ocrevus
.... 59.122 External - Medication Request: Ocrevus Zunovo - GPF
.... 59.123 External - Medication Request: Ocrevus Zunovo - Starter
.... 59.124 External - Medication Request: Pulmozyme
.... 59.125 External - Medication Request: Rituxan for Immunology
.... 59.126 External - Medication Request: Susvimo (Implant Kit)
.... 59.127 External - Medication Request: Susvimo (implant kit)
.... 59.128 External - Medication Request: Susvimo (Refill Kit)
.... 59.129 External - Medication Request: Tecentriq Hybreza
.... 59.130 External - Medication Request: Vabysmo (every 16 weeks)
.... 59.131 External - Medication Request: Vabysmo (every 4 weeks)
.... 59.132 External - MedicationRequest: Alecensa
.... 59.133 External - MedicationRequest: Cotellic
.... 59.134 External - MedicationRequest: Erivedge
.... 59.135 External - MedicationRequest: Herceptin
.... 59.136 External - MedicationRequest: Lunsumio
.... 59.137 External - MedicationRequest: Rozlytrek
.... 59.138 External - Resource Example: OperationOutcome 
.... 59.139 External - Resource Example: Organization (Practice)
.... 59.140 External - Resource Example:  MessageHeader
.... 59.141 External - Rozlytrek QuestionnaireResponse
.... 59.142 External - SOT Organization example
.... 59.143 External - UAPI AS Digital Consent: Consent by RelatedPerson
.... 59.144 External - UAPI AS Enrollment: Actemra Subcutaneous
.... 59.145 External - UAPI AS Enrollment: Alecensa
.... 59.146 External - UAPI AS Enrollment: Avastin
.... 59.147 External - UAPI AS Enrollment: Columvi
.... 59.148 External - UAPI AS Enrollment: Cotellic
.... 59.149 External - UAPI AS Enrollment: Enspryng
.... 59.150 External - UAPI AS Enrollment: Erivedge
.... 59.151 External - UAPI AS Enrollment: Gazyva
.... 59.152 External - UAPI AS Enrollment: Hemlibra
.... 59.153 External - UAPI AS Enrollment: Herceptin Hylecta
.... 59.154 External - UAPI AS Enrollment: Lucentis
.... 59.155 External - UAPI AS Enrollment: Ocrevus
.... 59.156 External - UAPI AS Enrollment: Perjeta
.... 59.157 External - UAPI AS Enrollment: Polivy
.... 59.158 External - UAPI AS Enrollment: Pulmozyme
.... 59.159 External - UAPI AS Enrollment: Rituxan for Immunology
.... 59.160 External - UAPI AS Enrollment: Rituxan for Oncology
.... 59.161 External - UAPI AS Enrollment: Rituxan Hycela
.... 59.162 External - UAPI AS Enrollment: Rozlytrek
.... 59.163 External - UAPI AS Enrollment: Susvimo
.... 59.164 External - UAPI AS Enrollment: Vabysmo
.... 59.165 External - UAPI AS Enrollment: Venclexta
.... 59.166 External - UAPI AS Enrollment: Xolair
.... 59.167 External - UAPI AS Enrollment: Evrysdi
.... 59.168 External - UAPI AS Enrollment: Kadcyla
.... 59.169 External - UAPI AS Enrollment: Phesgo
.... 59.170 External - UAPI AS Enrollment: Tecentriq
.... 59.171 External - UAPI AS Patient Consent Only
.... 59.172 External - UAPI AS Patient Consent: Consent for Marketing Info
.... 59.173 External - UAPI Copay Card Enrollment REQUEST 1
.... 59.174 External - UAPI Copay Card Enrollment REQUEST 2
.... 59.175 External - UAPI Copay Card Enrollment REQUEST 3
.... 59.176 External - UAPI Copay Card Enrollment REQUEST 4
.... 59.177 External - UAPI Copay Card Enrollment REQUEST 5
.... 59.178 External - UAPI Copay Card Enrollment REQUEST 6
.... 59.179 External - UAPI Copay Card Enrollment RESPONSE 1
.... 59.180 External - UAPI Copay Card Enrollment RESPONSE 2
.... 59.181 External - UAPI Copay Card Enrollment RESPONSE 3
.... 59.182 External - UAPI Copay claim upsert - bundle of claim bundles
.... 59.183 External - UAPI Copay Explanation of Benefit in copay enrollment response
.... 59.184 External - UAPI Copay Explanation of Benefit in copay enrollment response
.... 59.185 External - UAPI Copay Operation Outcome in copay enrollment response with errors
.... 59.186 External - UAPI Copay request-response enrollment bundle - success
.... 59.187 External - UAPI Copay Search Request
.... 59.188 External - UAPI Copay Update Request
.... 59.189 External - UAPI Copay Update Response
.... 59.190 External - UAPI GPF Enrollment: Herceptin
.... 59.191 External - UAPI GPF Enrollment: Lunsumio
.... 59.192 External - UAPI GPF Enrollment: Itovebi
.... 59.193 External - UAPI GPF Enrollment: Susvimo
.... 59.194 External - UAPI Response to Copay Search request - example returning 2 matching patients.
.... 59.195 External - UAPI Status Query REQUEST
.... 59.196 External - UAPI Status Query RESPONSE:  BIPA
.... 59.197 External - UAPI Status Query RESPONSE:  GPF
.... 59.198 Internal - UAPI AS Enrollment for MPS Redesign biPA Bundle Before (Ocrevus)
.... 59.199 Internal - UAPI Copay request-response combined bundle - error
.... 59.200 Internal - UAPI Copay request-response combined bundle - success
.... 59.201 Internal - UAPI Query 2
.... 59.202 Internal - UAPI Status Update C&R
.... 59.203 Internal - UAPI Status Update GPF
.... 59.204 mr-Avastin
.... 59.205 mr-Columvi
.... 59.206 mr-Gazyva
.... 59.207 mr-HerceptinHylecta
.... 59.208 mr-Kadcyla
.... 59.209 mr-Perjeta
.... 59.210 mr-Perjeta1
.... 59.211 mr-Phesgo
.... 59.212 mr-Phesgo1
.... 59.213 mr-Polivy
.... 59.214 mr-Polivy1
.... 59.215 mr-Pulmozyme
.... 59.216 mr-Regimen
.... 59.217 mr-Regimen2
.... 59.218 mr-RituxanForOncology
.... 59.219 mr-RituxanHycela
.... 59.220 mr-RituxanHycela1
.... 59.221 mr-RituxanOncology
.... 59.222 mr-Tecentriq2
.... 59.223 mr-Tecentriq3
.... 59.224 mr-xolair
.... 59.225 mr-Zelboraf
.... 59.226 mr-Zelboraf1