Retrievals

  • A retrieval represents a request to a provider or network

    • Networks are a group of providers that we can retrieve medical records from. Examples:
    • Providers are hospitals, clinics, doctors data we can retrieve medical records from
    • Currently, only EMR networks require specific providers
  • To create a retrieval, you need to create a call to POST /retrievals sending:

    • Retrieval type id
    • Life id
    • Date Ranges (to define the period of time you want medical records from)
    • Notes (if ancillary information needs to be added to the request)
    • Identifier( A field that an application can send a string to in order to identify the retrieval on their side)
  • After an application creates a retrieval, an authorization will be automatically generated to ask the patient to allow the app to proceed with the retrieval. The retrieval will be pending until Medchart receives the patient-accepted authorization back.

  • Each Retrieval will have a list of tracking that you can use to follow the progress of the retrieval

  • Retrieval status:

    • New
    • Pending
    • Cancelled
    • Completed

Retrieval Type

  • Retrieval types are options to retrieve medical records from a provider or network

    • Each provider has a list of retrieval types
    • The retrieval type could be kind single or multiple
    • Single means you will receive data just for that specific provider
    • Multiple means that you might receive data from other providers in the network too
    • A network will always have a retrieval type. This means that, when you request records and if there are no specific providers, the requestor will get everything from the network. In other instances, you can request records from specific provider.
    • Retrieval types have price, authorization type and network that the retrieval will be fulfilled.
  • To select a retrieval type you need:

    • to search for a provider using GET /providers?{searchParams}
    • or search for a network using GET /networks?{searchParams}
    • Inside network and provider objects you will find a list of options (retrieval types) to retrieve data from a provider/network
  • In the retrieval type you will find the following info:

    • Price
    • Authorization type
    • Network
    • ETA (avg. days)
    • DataType – Digital or Manual
    • DataSubType – CCDA, PDF, FHIR, ACORD-1122, XML, etc...
  • After the authorization is approved the retrieval will automatically be triggered and it will contact the provider/network to request the medical records

    • The medical record will be stored in the data Api after received from provider/network
    • After the data is stored an authorization will be automatically created to ask the patient to allow the app to access it.
    • After authorized the app will be able to access the data retrieved.

Did this page help you?