Create Dawakhana Standalone Return
curl --request POST \
--url https://api.eka.care/ipd/v1/service/dawakhana/orders/returns \
--header 'Content-Type: application/json' \
--header 'auth: <auth>' \
--data '
{
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"ipdId": "IPD-2026-0042",
"reason": "Unused medicines",
"lines": [
{
"medicineId": "med-paracetamol-500",
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"qty": 4,
"rate": 4.5
}
]
}
'import requests
url = "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns"
payload = {
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"ipdId": "IPD-2026-0042",
"reason": "Unused medicines",
"lines": [
{
"medicineId": "med-paracetamol-500",
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"qty": 4,
"rate": 4.5
}
]
}
headers = {
"auth": "<auth>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {auth: '<auth>', 'Content-Type': 'application/json'},
body: JSON.stringify({
admissionId: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
ipdId: 'IPD-2026-0042',
reason: 'Unused medicines',
lines: [
{
medicineId: 'med-paracetamol-500',
name: 'Paracetamol 500mg Tablet',
genericName: 'Paracetamol',
qty: 4,
rate: 4.5
}
]
})
};
fetch('https://api.eka.care/ipd/v1/service/dawakhana/orders/returns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'admissionId' => 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
'ipdId' => 'IPD-2026-0042',
'reason' => 'Unused medicines',
'lines' => [
[
'medicineId' => 'med-paracetamol-500',
'name' => 'Paracetamol 500mg Tablet',
'genericName' => 'Paracetamol',
'qty' => 4,
'rate' => 4.5
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"auth: <auth>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns"
payload := strings.NewReader("{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("auth", "<auth>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.eka.care/ipd/v1/service/dawakhana/orders/returns")
.header("auth", "<auth>")
.header("Content-Type", "application/json")
.body("{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eka.care/ipd/v1/service/dawakhana/orders/returns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["auth"] = '<auth>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "66f1ce18e4b0a1b2c3d4f00c",
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"kind": "return",
"orderNumber": "DW-K3M8P2QX",
"ipdId": "IPD-2026-0042",
"status": "RETURNED",
"createdBy": "161467756044204",
"createdByName": "Meena Iyer",
"isCollected": false,
"provider": "dawakhana",
"patientName": "Ravi Kumar",
"returnReason": "Unused medicines",
"returnedTotal": 18,
"createdAt": "2026-10-07T15:00:00.000Z",
"updatedAt": "2026-10-07T15:00:00.000Z",
"lineItems": [
{
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"medicineId": "med-paracetamol-500",
"orderedQty": 4,
"fulfilledQty": 4,
"rate": 4.5,
"amount": 18
}
]
}
}{
"success": false,
"error": "At least one return line is required"
}{
"message": "<string>"
}Dawakhana
Create Dawakhana Standalone Return
Overview
This API records a standalone return to the in-house pharmacy for an IPD admission of your workspace — medicines taken back that are not tied to a dispatched order. For a return against a dispatched order, use Return Dawakhana Order instead.
Each line’s qty × rate is deducted from the admission’s bill. The return is saved as a return order (kind: return, with no parentOrderId) and is listed in List Orders and List Dawakhana Orders. The patient details are taken from the admission’s existing orders.
At least one line is required. The user making the request is recorded as the creator.
POST
/
ipd
/
v1
/
service
/
dawakhana
/
orders
/
returns
Create Dawakhana Standalone Return
curl --request POST \
--url https://api.eka.care/ipd/v1/service/dawakhana/orders/returns \
--header 'Content-Type: application/json' \
--header 'auth: <auth>' \
--data '
{
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"ipdId": "IPD-2026-0042",
"reason": "Unused medicines",
"lines": [
{
"medicineId": "med-paracetamol-500",
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"qty": 4,
"rate": 4.5
}
]
}
'import requests
url = "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns"
payload = {
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"ipdId": "IPD-2026-0042",
"reason": "Unused medicines",
"lines": [
{
"medicineId": "med-paracetamol-500",
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"qty": 4,
"rate": 4.5
}
]
}
headers = {
"auth": "<auth>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {auth: '<auth>', 'Content-Type': 'application/json'},
body: JSON.stringify({
admissionId: 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
ipdId: 'IPD-2026-0042',
reason: 'Unused medicines',
lines: [
{
medicineId: 'med-paracetamol-500',
name: 'Paracetamol 500mg Tablet',
genericName: 'Paracetamol',
qty: 4,
rate: 4.5
}
]
})
};
fetch('https://api.eka.care/ipd/v1/service/dawakhana/orders/returns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'admissionId' => 'a1b2c3d4-5678-90ab-cdef-1234567890ab',
'ipdId' => 'IPD-2026-0042',
'reason' => 'Unused medicines',
'lines' => [
[
'medicineId' => 'med-paracetamol-500',
'name' => 'Paracetamol 500mg Tablet',
'genericName' => 'Paracetamol',
'qty' => 4,
'rate' => 4.5
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"auth: <auth>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eka.care/ipd/v1/service/dawakhana/orders/returns"
payload := strings.NewReader("{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("auth", "<auth>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.eka.care/ipd/v1/service/dawakhana/orders/returns")
.header("auth", "<auth>")
.header("Content-Type", "application/json")
.body("{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eka.care/ipd/v1/service/dawakhana/orders/returns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["auth"] = '<auth>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"admissionId\": \"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\n \"ipdId\": \"IPD-2026-0042\",\n \"reason\": \"Unused medicines\",\n \"lines\": [\n {\n \"medicineId\": \"med-paracetamol-500\",\n \"name\": \"Paracetamol 500mg Tablet\",\n \"genericName\": \"Paracetamol\",\n \"qty\": 4,\n \"rate\": 4.5\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "66f1ce18e4b0a1b2c3d4f00c",
"admissionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"kind": "return",
"orderNumber": "DW-K3M8P2QX",
"ipdId": "IPD-2026-0042",
"status": "RETURNED",
"createdBy": "161467756044204",
"createdByName": "Meena Iyer",
"isCollected": false,
"provider": "dawakhana",
"patientName": "Ravi Kumar",
"returnReason": "Unused medicines",
"returnedTotal": 18,
"createdAt": "2026-10-07T15:00:00.000Z",
"updatedAt": "2026-10-07T15:00:00.000Z",
"lineItems": [
{
"name": "Paracetamol 500mg Tablet",
"genericName": "Paracetamol",
"medicineId": "med-paracetamol-500",
"orderedQty": 4,
"fulfilledQty": 4,
"rate": 4.5,
"amount": 18
}
]
}
}{
"success": false,
"error": "At least one return line is required"
}{
"message": "<string>"
}Headers
Body
application/json
The return to record.
Was this page helpful?

