​
Benefits Check Status

  • REQUESTED
  • AWAITING_SILNA → Silna is working on the benefits check
  • AWAITING_PROVIDER → There is an open escalation on a benefits check which requires provider action
  • COMPLETE → The benefits check is finished and you can use the response from GET Benefits Check API. This is a terminal state.
  • WITHDRAWN → The benefits check will no longer be worked on. A benefits check can be withdrawn when a patient plan is archived or through the Silna app. This is a terminal state.

​
Benefits Check Lifecycle

When you create a benefits check, it will move into the REQUESTED and then into the AWAITING_SILNA state automatically. When Silna is finished completing the benefits check, it will move to the COMPLETE state. This is the happy path! If there is a problem completing a benefits check, we might need to raise an escalation. When we raise an escalation for a benefits check, it will move to the AWAITING_PROVIDER state. Once a provider resolves the escalation, it will move back to the AWAITING_SILNA state. If a benefits check is no longer needed, then a provider can withdraw it. When this happens, it moves to a WITHDRAWN state.

​
Creating Benefit Check for a New Patient

To create a benefit check, you will need to do the following steps:
  1. Follow the guide for Patient Creation to create a new patient.
  2. Use the patient_id from the response above to create a patient plan by following the guide for Patient Plan Creation.
  3. Use the patient_plan_id from the response above to create a benefit check by following the guide for Benefit Check Creation.
  4. It can take some time for Silna to complete a benefit check. We recommend polling the benefit check status by calling the Get Benefits Check API (with the benefits_check_id returned by the above API call). Terminal states for a Benefits Check are COMPLETE and WITHDRAWN. At times, it can take a couple of days for a benefits check to move to a terminal state so we recommend polling every hour or so.
  5. Once the benefits check is complete, you can get the benefits check pdf report by calling the Get Benefits Check Report API and then calling the Get File API with the file_id from the response.

​
Creating a Benefit Check for an Existing Patient

To create a benefit check for an existing patient, you will take the same steps as above with the below modifications.
  • Instead of using the Create Patient API, you will use the Update Patient or Create or Update Patient API if you need to update any patient information. If you are storing the Silna patient_id in your system, then you can use the Update Patient API. If you are using your own id (source_id), then you should use the Create or Update Patient API. If this state of the patient in our system is unknown to you, then use the Create or Update Patient API.
  • If you want to create a benefits check for a new plan, you will need to follow the guide for Patient Plan Creation. If it’s for an existing plan, you will use the Get Patient Plans API or PUT Patient Plan API . Again, if the state of the patient plan in our system is unknown to you, then use the PUT Patient Plan API.

​
(Near) Realtime Benefits

To use Silna’s realtime benefits checks, please reach out to your Silna contact to create a realtime template for you to use. They will then give you the name of the template. To get realtime benefits for a patient plan through the Silna API, you need to pass in the correct template_id to the Post Benefits Checks API. You can get the correct template_id by searching the Get Benefits Check Templates API with the template name provided by your Silna contact. It usually takes a few seconds for a Silna realtime benefits checks to complete, but you should be prepared for it to take up to a minute in some cases.