TRtruepill
api

Create Fill Request

Generate a Fill Request to fill/refill prescriptions and order Over-the-Counter (OTC) products<br/><br/>The prescriptions and products requested can be shipped to your patient with various shipping methods.<br/><br/>When making a Fill Request, the patient will be referenced with a patient_token being passed into the request body. If you do not have a patient_token for your Patient, one can be created using the Patient Create endpoint.<br/><br/>On a successful submission of the Fill Request, a fill request token will be provided that is used to reference the Fill Request (similar to prescription_token and patient_token).<br/><br/>This attribute is returned under the field request_id.<br/><br/>Many fields for the Fill Request may or may not be required depending on what values are passed in. Please reference the field information carefully.<br/><br/>The metadata field acts as a link between the Fill Request in the Truepill and the customer systems. It will be provided in all subsequent Fill Request notifications as the order is processed.

post/api/v1/fill_request

Request

Request body

patient_tokenstring

Patient token

patient_payment_type'cash' | 'insurance' required
insurancesstring
address_to_namestring required
address_to_companystring
address_to_street1string required
address_to_street2string
address_to_citystring required
address_to_statestring required
address_to_zipstring required
address_to_countrystring
address_to_phonestring required
address_to_emailstring
shipping_method'standard' | 'priority' | 'overnight' | 'usps_ground_advantage' | 'usps_priority' | 'usps_priority_express' | 'fedex_ground' | 'fedex_2_day' | 'fedex_smart_post' | 'fedex_standard_overnight' | 'fedex_priority_overnight' | 'ups_mail_innovations_domestic' | 'ups_next_day_air' | 'ups_next_day_air_saver' | 'ups_second_day_air' | 'ups_ground' | 'dhl_ecommerce_parcels_ground' | 'dhl_ecommerce_parcels_expedited' | 'dhl_ecommerce_parcels_expedited_max' | 'dhl_ecommerce_parcel_plus_ground' | 'dhl_ecommerce_parcel_plus_expedited' | 'dhl_ecommerce_parcel_plus_expedited_max'

Shipping method

signature_confirmationboolean

Is signature required by patient upon delivery

replacement_orderstring

Fill Request token of the order that this Fill request is replacing

metadatastring
notesstring
patient_surveyPatient20survey required(unresolved $ref)
check_inboolean

Set to true to request a consultation with a Truepill pharmacist prior to completing the Fill request

is_priorityboolean
packaging_instructionsstring

Response

Accepted

request_idstring
timestampinteger
statusstring

Example response

{
  "request_id": "fill_request_d1f54cea86bb7e030f09",
  "timestamp": 1631571795,
  "status": "success",
  "details": {
    "message": "Your fill request has been processed successfully.",
    "metadata": "Some metadata"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.