---
title: "Create Fill Request"
method: POST
path: "/api/v1/fill_request"
tags: ["api"]
---

# Create Fill Request

`POST /api/v1/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.

## Request body

- Model147
  - `patient_token` string — Patient token
  - `patient_payment_type` 'cash' | 'insurance', required
  - `insurances` string
  - `medications` Medication[]
    - `medication_name` string — Medication name
    - `quantity_dispensed` number — Dispensed medication quantity
    - `days_supply` number — Days supply
    - `is_refill` boolean — Is prescription a refill or new fill
    - `medication_sig` string — Recommendations for medicines
    - `prescribing_doctor` string — Prescribing doctor
    - `prescription_token` string — Prescription token
    - `rx_link` string
    - `quantity` number — Quantity sent
    - `copay_payment` CopayPayment
      - `cardholder_name` string — Cardholder name
      - `payment_type` string, required
      - `last_four_digits` string
      - `transaction_amount` number
      - `card_type` string
      - `transaction_date` string
      - `transaction_id` string
    - `ndc` string — National drug code
    - `daw` '0' | '2', required
    - `patient_consent` PatientConsent
      - `consent_statement` string
      - `consent_method` string
      - `consent_date` string
      - `consent_type` string
      - `patient_name` string
      - `consent_provided_by` string
      - `item` string
  - `packing_materials` Model144[]
    - `sku` string, required — Store keeping unit
    - `quantity` number, required — Quantity
  - `otc_products` Model145[]
    - `item` string
    - `sku` string — Store keeping unit
    - `bundle_id` string
    - `bundle_item_partial_return_allowed` boolean
    - `quantity` number, required — Quantity
    - `customer_item_id` string — Customer item ID
    - `days_supply` number — Days supply
    - `pricing` Pricing
      - `cost` number
      - `tax` number
      - `total` number
    - `patient_consent` PatientConsent
      - `consent_statement` string
      - `consent_method` string
      - `consent_date` string
      - `consent_type` string
      - `patient_name` string
      - `consent_provided_by` string
      - `item` string
  - `address_to_name` string, required
  - `address_to_company` string
  - `address_to_street1` string, required
  - `address_to_street2` string
  - `address_to_city` string, required
  - `address_to_state` string, required
  - `address_to_zip` string, required
  - `address_to_country` string
  - `address_to_phone` string, required
  - `address_to_email` string
  - `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_confirmation` boolean — Is signature required by patient upon delivery
  - `replacement_order` string — Fill Request token of the order that this Fill request is replacing
  - `metadata` string
  - `notes` string
  - `patient_survey` Patient20survey, required — unresolved $ref
  - `check_in` boolean — Set to true to request a consultation with a Truepill pharmacist prior to completing the Fill request
  - `is_priority` boolean
  - `packaging_instructions` string
  - `receipt_items` Model20[]
    - `category` 'prescription_copay' | 'tax' | 'shipping' | 'prescription_cash' | 'tax_copay' | 'processing_fee', required
    - `prescription_token` string, required
    - `amount` number, required
    - `description` string
  - `stripe_payment` StripePayment
    - `category` string, required
    - `cardholder_name` string
    - `last_four_digits` string
    - `stripe_id` string, required
    - `amount` number, required
    - `description` string

## Response `202`

Accepted

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/truepill/apis/truepill-api-documentation.md) · [All operations](https://skmtc.dev/truepill/apis/truepill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truepill/truepill-api-documentation/revisions/d9aaa355c1e0/schema)