API OVERVIEW

Pagination

Request IDs

Versioning

Rate Limits

CLINIC

Clinic

Retrieve a clinic

PATIENTS

Treatment Plans

The treatment plan object is the way for practitioners create prescriptions in Fullscript. The API allows you to create treatment plans. It also allows you to list all treatment plans that belong to a patient and find individual treatment plans.

Activate a treatment plan

This endpoint is restricted

This endpoint is not available for general use. Access is highly restricted, and most requests will not be granted. If you believe your case is critical, you may submit a request for consideration. We will only respond if your request is relevant.

Activates a draft Treatment Plan for a patient.

Arguments

treatment_plan_id

string

Required

Unique ID for the Treatment plan.

PATCH /api/clinic/treatment_plans/{treatment_plan_id}/activate
curl -X 'PATCH' "https://api-us-snd.fullscript.io/api/clinic/treatment_plans/{treatment_plan_id}/activate" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Responses

Cancel a treatment plan

Cancels an active Treatment Plan for a patient.

Arguments

treatment_plan_id

string

Required

Unique ID for the Treatment plan.

PATCH /api/clinic/treatment_plans/{treatment_plan_id}/cancel
curl -X 'PATCH' "https://api-us-snd.fullscript.io/api/clinic/treatment_plans/{treatment_plan_id}/cancel" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Responses

List all patient treatment plans

This resource allows you to list all of a patient's treatment plans.

Arguments

patient_id

string

Required

Unique ID for the Patient

sort_by

string

Accepts one of the following arguments: created_at or updated_at.

order_by

string

Ordering defaults to ASC and can take an argument of ASC or DESC.

GET /api/clinic/patients/{patient_id}/treatment_plans
curl "https://api-us-snd.fullscript.io/api/clinic/patients/{patient_id}/treatment_plans" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Responses

Create a patient treatment plan

This endpoint is restricted

This endpoint is not available for general use. Access is highly restricted, and most requests will not be granted. If you believe your case is critical, you may submit a request for consideration. We will only respond if your request is relevant.

Creates a new Treatment Plan for a patient.

Arguments

patient_id

string

Required

Unique ID for the Patient.

practitioner_id

string

Unique practitioner ID. Required if the current access token's resource owner type is Staff or Clinic. Otherwise defaults to the practitioner who owns the token, but can be specified to create the plan on behalf of a different practitioner.

personal_message

string

A personal message that a practitioner can attach to the treatment plan.

state

string

The state of the treatment plan. Takes an option of draft or active. Defaults to active if null. The value draft allows to create a draft treatment plan. The value active or null creates an active treatment plan.

recommendations

array

Required

Rx plan for a product.

variant_id

string

Required

Unique ID for the Variant.

units_to_purchase

string

Required

Quantity (number of units) of variant to recommend.

refill

string

Send refill reminders?

take_with

string

What the product should be taken with. This can be any of the following strings: empty stomach, food, or water.

dosage

object

Dosage information for the recommendation.

amount

string

The dose to take. Expects numbers but can include a range or a fraction (e.g. 1, or 1-2, or 1/2 are all valid).

frequency

string

The frequency with which to take the dose. This can be any of the following strings: once per day, twice per day, three times per day, four times per day, every morning, or every night.

duration

string

The period for which to take the dose. This can be the number of days (e.g. 120 for 4 months) or it can be any of the following strings: as needed, until symptoms resolve, or ongoing.

additional_info

string

Extra instructions for taking dose (e.g. With meals).

format

string

Format of the recommended dose. This can be any of the following strings: capsule, chewable, gel, liquid, lozenge, packet, pellet, drops, powder, strip, suppository, or tablet.

time_of_day

string

The time(s) of day at which to take the dose. This can be any combination of the following strings: upon waking, morning, afternoon, evening, and bedtime.

metadata

object

Metadata to be attached to the treatment_plan.

id

string

Your system's unique treatment_plan identifier.

POST /api/clinic/patients/{patient_id}/treatment_plans
curl -X 'POST' "https://api-us-snd.fullscript.io/api/clinic/patients/{patient_id}/treatment_plans" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX' \ -d $'{ "practitioner_id": "string", "personal_message": "string", "state": "string", "recommendations": [ { "variant_id": "string", "units_to_purchase": "string", "refill": "string", "take_with": "string", "dosage": { "amount": "string", "frequency": "string", "duration": "string", "additional_info": "string", "format": "string", "time_of_day": "string" } } ], "metadata": { "id": "string" } }'

Responses

Retrieve a treatment plan

Retrieves an existing treatment plan. You need to supply the unique ID for the treatment plan.

Arguments

id

string

Required

Unique ID for the Treatment Plan

GET /api/clinic/treatment_plans/{id}
curl "https://api-us-snd.fullscript.io/api/clinic/treatment_plans/{id}" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Responses

Update a treatment plan

Updates a Treatment Plan for a patient.

Arguments

id

string

Required

Unique ID for the Treatment plan.

personal_message

string

A personal message that a practitioner can attach to the treatment plan.

recommendations

array

Rx plan for a product.

variant_id

string

Required

Unique ID for the Variant.

units_to_purchase

string

Required

Quantity (number of units) of variant to recommend.

refill

string

Send refill reminders?

take_with

string

What the product should be taken with. This can be any of the following strings: empty stomach, food, or water.

dosage

object

Dosage information for the for the recommednation.

amount

string

The dose to take. Expects numbers but can include a range or a fraction (e.g. 1, or 1-2, or 1/2 are all valid).

frequency

string

The frequency with which to take the dose. This can be any of the following strings: once per day, twice per day, three times per day, four times per day, every morning, or every night.

duration

string

The period for which to take the dose. This can be the number of days (e.g. 120 for 4 months) or it can be any of the following strings: as needed, until symptoms resolve, or ongoing.

additional_info

string

Extra instructions for taking dose (e.g. With meals).

format

string

Format of the recommended dose. This can be any of the following strings: capsule, chewable, gel, liquid, lozenge, packet, pellet, drops, powder, strip, suppository, or tablet.

time_of_day

string

The time(s) of day at which to take the dose. This can be any combination of the following strings: upon waking, morning, afternoon, evening, and bedtime.

resource_ids

array

The Resource IDs to be attached to the Treatment Plan.

metadata

object

Metadata to be attached to the treatment_plan.

id

string

Your system's unique treatment_plan identifier.

PATCH /api/clinic/treatment_plans/{id}
curl -X 'PATCH' "https://api-us-snd.fullscript.io/api/clinic/treatment_plans/{id}" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX' \ -d $'{ "personal_message": "string", "recommendations": [ { "variant_id": "string", "units_to_purchase": "string", "refill": "string", "take_with": "string", "dosage": { "amount": "string", "frequency": "string", "duration": "string", "additional_info": "string", "format": "string", "time_of_day": "string" } } ], "resource_ids": "array", "metadata": { "id": "string" } }'

Responses

Create an in-office checkout

The in_office_checkout object takes a treatment_plan. It uses the patient from the treatment_plan to:

a) clear out anything in the patient's cart.

b) populate the patient's cart with the treatment plan.

c) return a url on Fullscript so that a practitioner can fullfill an in-office checkout.

Arguments

treatment_plan_id

string

Required

Unique ID for the Treatment Plan

POST /api/clinic/treatment_plans/{treatment_plan_id}/in_office_checkout
curl -X 'POST' "https://api-us-snd.fullscript.io/api/clinic/treatment_plans/{treatment_plan_id}/in_office_checkout" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Responses