{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","code-snippet"]},"type":"markdown"},"seo":{"title":"Provider implementation","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"provider-implementation","__idx":0},"children":["Provider implementation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-1up-electronic-prior-authorization","__idx":1},"children":["What is 1up Electronic Prior Authorization?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["1up Electronic Prior Authorization enables providers to confirm whether prior authorization is necessary for a given service or procedure, verify member coverage, discover specific prior authorization documentation requirements, and submit a prior authorization request to health plans partnered with 1up."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payers with the following health plans must support Electronic Prior Authorization by January 1st, 2027 due to the 2024 CMS Interoperability and Prior Authorization final rule (CMS-0057-F):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Medicare Advantage (MA)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Medicaid"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Children's Health Insurance Program (CHIP)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Qualified Health Plan (QHP) issuers on the Federally-facilitated Exchanges (FFEs)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-does-electronic-prior-authorization-epa-work","__idx":2},"children":["How does Electronic Prior Authorization (EPA) work?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Electronic Prior Authorization is made up of three APIs:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/epa/crd"},"children":["Coverage Requirements Discovery (CRD)"]}," verifies the member's coverage and clarifies if prior authorization is required during the provider's normal workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/epa/dtr"},"children":["Documentation Templates and Rules (DTR)"]}," gathers any required documents and prompts providers to answer questions related to the EPA request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/epa/pas"},"children":["Prior Authorization Support (PAS)"]}," submits the prior authorization request to the patient's health plan."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer-engagement@1up.health"]}," to request EPA client credentials for OAuth 2.0. You must have client credentials for either the demo or production environments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start-with-the-demo-environment","__idx":4},"children":["Quick-start with the demo environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/epa/provider-implementation#authentication"},"children":["Authentication"]}," to receive the necessary client credentials for 1up's OAuth 2.0 configuration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-a-demo-bearer-token","__idx":5},"children":["Request a demo Bearer token"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Placeholder"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace the curly brackets ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," and all text inside them with the client credentials provided to you."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -I -X POST 'https://gateway.1upcoreuat.com/auth/realms/epa-uat/protocol/openid-connect/token' \\\n    -H 'Content-Type: application/x-www-form-urlencoded' \\\n    -d 'client_id={your_client_id}' \\\n    -d 'client_secret={your_client_secret}' \\\n    -d 'grant_type=client_credentials'\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"crd-discovery-endpoint-cds-services","__idx":6},"children":["CRD discovery endpoint: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The IT staff at provider organizations will configure their EHR and other CDS clients to request data from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}," endpoint that is used for all subsequent APIs for EPA."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/static/code/epa-demo-cds-request.md","language":"curl","title":"Example request to demo `cds-services` endpoint","header":{"title":"Example request to demo `cds-services` endpoint","controls":{"copy":{}}},"lang":"curl","source":"curl -I -X GET 'https://gateway.1upcoreuat.com/v1/1upcoreuat/crd-prod/demo/demo/cds-services' \\\n    -H 'Authorization: Bearer {access_token}'"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response below to the demo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}," request includes the operations we support and prefetch requirements. Production implementations use a different URL from the demo to reach the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}," endpoint."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Example only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}," response is only an example. CDS clients should be configured to request the production ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cds-services"]}," endpoint to ensure up-to-date information."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/static/code/epa-demo-cds-response.md","language":"json","title":"Example response to `cds-services` request","header":{"title":"Example response to `cds-services` request","controls":{"copy":{}}},"lang":"json","source":"{\n    \"services\": [\n        {\n            \"hook\": \"order-sign\",\n            \"title\": \"Clinical Decision Support | Coverage Requirements Discovery Service\",\n            \"description\": \"Da Vinci Order Sign endpoint for CRD. Provides coverage information including prior authorization requirements\",\n            \"id\": \"order-sign\",\n            \"prefetch\": {\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\",\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\"\n            }\n        },\n        {\n            \"hook\": \"appointment-book\",\n            \"title\": \"Clinical Decision Support | Appointment Book\",\n            \"description\": \"Da Vinci Appointment Book endpoint for CRD. Provides coverage information for scheduled appointments\",\n            \"id\": \"appointment-book\",\n            \"prefetch\": {\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\",\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\"\n            }\n        },\n        {\n            \"hook\": \"order-select\",\n            \"title\": \"Clinical Decision Support | Coverage Requirements Discovery Service\",\n            \"description\": \"Da Vinci Order Select endpoint for CRD. Provides coverage information during order selection\",\n            \"id\": \"order-select\",\n            \"prefetch\": {\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\",\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\"\n            }\n        },\n        {\n            \"hook\": \"order-dispatch\",\n            \"title\": \"Clinical Decision Support | Coverage Requirements Discovery Service\",\n            \"description\": \"Provides coverage information including prior authorization requirements\",\n            \"id\": \"order-dispatch\",\n            \"prefetch\": {\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\",\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\"\n            }\n        },\n        {\n            \"hook\": \"encounter-start\",\n            \"title\": \"Clinical Decision Support | Encounter Start\",\n            \"description\": \"Da Vinci Encounter Start endpoint for CRD. Provides coverage information when an encounter begins\",\n            \"id\": \"encounter-start\",\n            \"prefetch\": {\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\",\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"encounter\": \"Encounter/{{context.encounterId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\"\n            }\n        },\n        {\n            \"hook\": \"encounter-discharge\",\n            \"title\": \"Clinical Decision Support | Encounter Discharge\",\n            \"description\": \"Da Vinci Encounter Discharge endpoint for CRD. Provides coverage information when discharging a patient\",\n            \"id\": \"encounter-discharge\",\n            \"prefetch\": {\n                \"location\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:locationReference\",\n                \"coverage\": \"Coverage?beneficiary=Patient/{{context.patientId}}\",\n                \"encounter\": \"Encounter/{{context.encounterId}}\",\n                \"performer\": \"ServiceRequest?_id={{context.draftOrders.ServiceRequest.id}}&_include=ServiceRequest:performer\",\n                \"patient\": \"Patient/{{context.patientId}}\"\n            }\n        }\n    ]\n}"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"supported-cpt-codes","__idx":7},"children":["Supported CPT codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When needed, use one of the CPT codes below for testing your implementation."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Expected outcome"},"children":["Expected outcome"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["81162"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PA Required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["27445"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PA Not Required"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"demo-subscriber-id","__idx":8},"children":["Demo subscriber ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When needed, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUB101"]}," for the subscriber ID in demo queries."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implement-cds-hooks-for-epa","__idx":9},"children":["Implement CDS hooks for EPA"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the documentation provided by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cds-hooks.hl7.org/2026Jan/en/"},"children":["HL7"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://hl7.org/fhir/us/davinci-hrex/1.2.0/en/"},"children":["Da Vinci"]},", and your specific Clinical Decision Support (CDS) clients, like your EMR, for guidance on implementing CDS hooks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-values-from-payers","__idx":10},"children":["Required values from payers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provider organizations must configure their EHR or other Clinical Decision Support (CDS) clients with the below values for each Coverage FHIR resource. These values are used as path parameters for requests to all three APIs. "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer-engagement@1up.health"]}," to receive the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerKey"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partitionKey"]}," values for production implementation."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier assigned to a payer organization by 1upHealth."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partitionKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier for one of a payer's health plans or lines of business."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Demo values"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["demo"]}," is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerKey"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partitionKey"]}," value for the demo environment."]}]}]},"headings":[{"value":"Provider implementation","id":"provider-implementation","depth":1},{"value":"What is 1up Electronic Prior Authorization?","id":"what-is-1up-electronic-prior-authorization","depth":2},{"value":"How does Electronic Prior Authorization (EPA) work?","id":"how-does-electronic-prior-authorization-epa-work","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Quick-start with the demo environment","id":"quick-start-with-the-demo-environment","depth":2},{"value":"Request a demo Bearer token","id":"request-a-demo-bearer-token","depth":3},{"value":"CRD discovery endpoint: cds-services","id":"crd-discovery-endpoint-cds-services","depth":2},{"value":"Supported CPT codes","id":"supported-cpt-codes","depth":3},{"value":"Demo subscriber ID","id":"demo-subscriber-id","depth":3},{"value":"Implement CDS hooks for EPA","id":"implement-cds-hooks-for-epa","depth":2},{"value":"Required values from payers","id":"required-values-from-payers","depth":3}],"frontmatter":{"seo":{"title":"Provider implementation"}},"lastModified":"2026-06-16T15:20:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/epa/provider-implementation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}