Create a prescription

Any signed in user. Records a pending prescription of one or more medicines for the branch. patient_name, prescriber_name, and at least one item required; stock is checked at dispense.

POST/api/v1/prescriptions

Authorization

AuthorizationBearer token (JWT) · headerrequired

JWT from POST /api/v1/auth/login sent as Authorization Bearer.

Request body

requiredapplication/json

patient_namestringrequired

patient_id_numberstring

prescriber_namestringrequired

prescriber_licensestring

notesstring

itemsobject[]required

Show properties

Array of object

medicine_idstringrequired

quantitynumber

dosage_instructionsstring

Responses

201

Prescription recorded

idstringrequired

branch_idstringrequired

rx_numberstringrequired

patient_namestringrequired

patient_id_numberstringrequired

prescriber_namestringrequired

prescriber_licensestringrequired

statusstringrequired

sale_idstring | nullrequired

dispensed_bystring | nullrequired

dispensed_by_namestring | nullrequired

notesstringrequired

created_bystringrequired

created_atstringrequired

updated_atstringrequired

dispensed_atstring | nullrequired

itemsobject[]required

Show properties

Array of object

idstringrequired

prescription_idstringrequired

medicine_idstringrequired

quantityintegerrequired

min -9007199254740991 · max 9007199254740991

dosage_instructionsstringrequired

medicine_namestringrequired

selling_pricestringrequired

vat_categorystringrequired

requires_prescriptionintegerrequired

min -9007199254740991 · max 9007199254740991

400

A required field is missing or the items list is empty

detailstringrequired

401

Not authenticated

detailstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST 'http://localhost:8000/api/v1/prescriptions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "patient_name": "string",
  "patient_id_number": "string",
  "prescriber_name": "string",
  "prescriber_license": "string",
  "notes": "string",
  "items": [
    {
      "medicine_id": "string",
      "quantity": 0,
      "dosage_instructions": "string"
    }
  ]
}'

const response = await fetch("http://localhost:8000/api/v1/prescriptions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"patient_name\": \"string\",\n  \"patient_id_number\": \"string\",\n  \"prescriber_name\": \"string\",\n  \"prescriber_license\": \"string\",\n  \"notes\": \"string\",\n  \"items\": [\n    {\n      \"medicine_id\": \"string\",\n      \"quantity\": 0,\n      \"dosage_instructions\": \"string\"\n    }\n  ]\n}"
});

import requests

response = requests.post(
    "http://localhost:8000/api/v1/prescriptions",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"patient_name\": \"string\",\n  \"patient_id_number\": \"string\",\n  \"prescriber_name\": \"string\",\n  \"prescriber_license\": \"string\",\n  \"notes\": \"string\",\n  \"items\": [\n    {\n      \"medicine_id\": \"string\",\n      \"quantity\": 0,\n      \"dosage_instructions\": \"string\"\n    }\n  ]\n}",
)

Response

{
  "id": "string",
  "branch_id": "string",
  "rx_number": "string",
  "patient_name": "string",
  "patient_id_number": "string",
  "prescriber_name": "string",
  "prescriber_license": "string",
  "status": "string",
  "sale_id": "string",
  "dispensed_by": "string",
  "dispensed_by_name": "string",
  "notes": "string",
  "created_by": "string",
  "created_at": "string",
  "updated_at": "string",
  "dispensed_at": "string",
  "items": [
    {
      "id": "string",
      "prescription_id": "string",
      "medicine_id": "string",
      "quantity": -9007199254740991,
      "dosage_instructions": "string",
      "medicine_name": "string",
      "selling_price": "string",
      "vat_category": "string",
      "requires_prescription": -9007199254740991
    }
  ]
}

{
  "detail": "string"
}

{
  "detail": "string"
}