---
title: "Create Direct Transfer"
method: POST
path: "/v1/direct_transfer"
tags: ["v1"]
---

# Create Direct Transfer

`POST /v1/direct_transfer`

Create a direct pharmacy-to-pharmacy transfer of the prescription<br/><br/>A direct transfer is a pharmacy-to-pharmacy transfer of the prescription between your pharmacy and a Truepill pharmacy. This method works best for customers that operate their own pharmacies and are looking for a programmatic way to transfer a prescription.<br/><br/>And similar to a traditional transfer request, there are required fields related to the pharmacist transferring out the prescription, and the pharmacist transferring in the prescription.<br/><br/>This approach requires a digital copy of the original prescription.

## Request body

- CreateDirectTransfer — Create new direct transfer
  - `metadata` string
  - `prescriber` Prescriber, required — Prescriber description
    - `prescriber_type` 'OD' | 'PMHNP' | 'MBBS' | 'DNP' | 'D.O.' | 'DPT' | 'D.D.S.' | 'F.N.P.' | 'CPP' | 'N.D.' | 'P.A.' | 'APNP' | 'V.M.D.' | 'RPh' | 'APRN' | 'DC APC' | 'PsyD' | 'CRNA' | 'PharmD' | 'B.V.M.S.' | 'WHNP' | 'PhD' | 'ARNP' | 'PT' | 'CRNP' | 'DPM' | 'CNP' | 'N.P.' | 'CDH' | 'D.M.D.' | 'D.V.M.' | 'M.D.' | 'CNM'
    - `first_name` string, required — Prescriber's first name
    - `last_name` string, required — Prescriber's last name
    - `address` Model138, required
      - `name` string, required
      - `street1` string, required — Primary street where the company is located
      - `city` string, required — City where the company is located
      - `state` string, required — State where the company is located
      - `zip` string, required — Postal code where the company is located
    - `dea` string
    - `npi` string, required — National provider identifier
  - `patient_token` string — Token to reference patient record
  - `transfer_from` TransferFrom, required — Pharmacy to transfer prescriptions from
    - `name` string, required — Name of pharmacy
    - `dea` string
    - `pharmacist` string, required
    - `id_number` string, required
    - `address` Model138, required
      - `name` string, required
      - `street1` string, required — Primary street where the company is located
      - `city` string, required — City where the company is located
      - `state` string, required — State where the company is located
      - `zip` string, required — Postal code where the company is located
  - `transfer_to` TransferTo, required — Pharmacy to transfer prescriptions to
    - `name` string, required — Name of pharmacy
    - `dea` string
    - `pharmacist` string, required
    - `id_number` string
  - `prescription` Model139, required — Prescription description
    - `medication_name` string, required — Medication name
    - `quantity_written` string, required — Written medication quantity
    - `quantity_dispensed` string — Dispensed medication
    - `medication_sig` string, required — Recommendations for medicines
    - `written_date` string, required — Written date
    - `expiration_date` string — Expiration date
    - `last_fill_date` string — Last fill date
    - `first_fill_date` string — First fill date
    - `number` string, required
    - `direct_transfer_url` string
    - `can_substitute` boolean, required
    - `prescribed_ndc` string — National drug code
    - `days_supply` integer — Days supply
    - `icd10_code` string
    - `notes` string — Text note
    - `annotation` string — Short annotation
    - `diagnosis` string — Diagnosis
    - `quantity_transferred` string — Quantity of medication transferred
    - `original_refills` integer — Original number of refills
  - `source` string

## Response `202`

Accepted

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[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)
