​
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.