> ## Documentation Index
> Fetch the complete documentation index at: https://developer.eka.care/llms.txt
> Use this file to discover all available pages before exploring further.

# List Dawakhana Orders

> 
### Overview

This API lists the **in-house pharmacy (Dawakhana) orders** of your workspace, newest first, each with its order lines. It is the pharmacist's work list: lines carry the ordered quantity and, once dispatched, the fulfilled quantity and rate.

All filters are optional:

- `status` — repeat the parameter to match several statuses (for example `status=RETURNED&status=PARTIALLY_RETURNED`).
- `from` / `to` — creation date range, as an ISO-8601 date or epoch milliseconds. **Ignored when `admissionId` is set**, so all orders of an admission are returned regardless of date.

Results are paged with `limit` (default `50`) and `skip` (default `0`).



## OpenAPI

````yaml get /ipd/v1/service/dawakhana/orders
openapi: 3.0.0
info:
  title: Ekacare API & Webhook Documentation
  contact: {}
  version: '1.0'
servers:
  - description: Production
    url: https://api.eka.care
  - description: Stage/Sandbox
    url: https://api.dev.eka.care
security: []
paths:
  /ipd/v1/service/dawakhana/orders:
    get:
      tags:
        - IPD API
      summary: List Dawakhana Orders
      description: >-

        ### Overview


        This API lists the **in-house pharmacy (Dawakhana) orders** of your
        workspace, newest first, each with its order lines. It is the
        pharmacist's work list: lines carry the ordered quantity and, once
        dispatched, the fulfilled quantity and rate.


        All filters are optional:


        - `status` — repeat the parameter to match several statuses (for example
        `status=RETURNED&status=PARTIALLY_RETURNED`).

        - `from` / `to` — creation date range, as an ISO-8601 date or epoch
        milliseconds. **Ignored when `admissionId` is set**, so all orders of an
        admission are returned regardless of date.


        Results are paged with `limit` (default `50`) and `skip` (default `0`).
      operationId: ListIpdDawakhanaOrders
      parameters:
        - name: auth
          in: header
          required: true
          schema:
            type: string
          example: >-
            eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiX2lkIjoiMTIzNDU2IiwiY2xpZW50X2lkIjoiNzg5MCIsImV4dHJhX2ZpZWxkIjoiZXh0cmFfZmllbGRfZGF0YSJ9.q9KzBI6f4l3OyM_EkB5Quq0l9EEMFh5JS-fx3F_PHUM
        - name: status
          in: query
          description: >-
            Only orders in these statuses. Repeat the parameter for more than
            one.
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - CREATED
                - DISPATCHED
                - CANCELLED
                - RETURNED
                - PARTIALLY_RETURNED
          style: form
          explode: true
        - name: from
          in: query
          description: >-
            Only orders created on or after this time (ISO-8601 date or epoch
            milliseconds). Ignored with `admissionId`.
          required: false
          schema:
            type: string
          example: '2026-10-07T00:00:00.000Z'
        - name: to
          in: query
          description: >-
            Only orders created on or before this time (ISO-8601 date or epoch
            milliseconds). Ignored with `admissionId`.
          required: false
          schema:
            type: string
          example: '2026-10-07T23:59:59.999Z'
        - name: admissionId
          in: query
          description: Only orders of this IPD admission (all dates).
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of orders to return. Defaults to `50`.
          required: false
          schema:
            type: number
            default: 50
        - name: skip
          in: query
          description: Number of orders to skip (for paging). Defaults to `0`.
          required: false
          schema:
            type: number
            default: 0
      responses:
        '200':
          description: OK — the matching Dawakhana orders with their lines.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/IpdDawakhanaOrder'
              example:
                success: true
                data:
                  - id: 66f1cd07e4b0a1b2c3d4ef0a
                    admissionId: a1b2c3d4-5678-90ab-cdef-1234567890ab
                    kind: order
                    orderNumber: DW-7Q2K9F3M
                    ipdId: IPD-2026-0042
                    status: CREATED
                    createdBy: '161467756044203'
                    createdByName: Vivek Sharma
                    isCollected: false
                    provider: dawakhana
                    patientName: Ravi Kumar
                    createdAt: '2026-10-07T12:10:00.000Z'
                    updatedAt: '2026-10-07T12:10:00.000Z'
                    lines:
                      - id: 66f1cd07e4b0a1b2c3d4ef0b
                        medicineId: med-paracetamol-500
                        name: Paracetamol 500mg Tablet
                        genericName: Paracetamol
                        orderedQty: 10
                        directions: 1 tablet every 6 hours
                        lineStatus: PENDING
        '400':
          description: >-
            Bad Request. Returns `{ success: false, error }` when `from` or `to`
            is not a valid date, or `{ message }` when a query parameter failed
            validation (for example an unknown `status`; the `message` is
            currently empty).
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/IpdServiceFailure'
                  - $ref: '#/components/schemas/IpdServiceError'
              example:
                success: false
                error: 'Invalid "from" date: yesterday'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpdServiceError'
      deprecated: false
components:
  schemas:
    IpdDawakhanaOrder:
      title: IpdDawakhanaOrder
      allOf:
        - $ref: '#/components/schemas/IpdOrder'
        - type: object
          properties:
            lines:
              type: array
              description: The order lines.
              items:
                $ref: '#/components/schemas/IpdDawakhanaLine'
    IpdServiceFailure:
      title: IpdServiceFailure
      type: object
      properties:
        success:
          type: boolean
          description: Always `false`.
        error:
          type: string
          description: Human-readable error message.
    IpdServiceError:
      title: IpdServiceError
      type: object
      properties:
        message:
          type: string
          description: Human-readable error message.
    IpdOrder:
      title: IpdOrder
      type: object
      properties:
        id:
          type: string
          description: Order id.
        admissionId:
          type: string
          description: Id of the IPD admission the order is for.
        kind:
          type: string
          enum:
            - order
            - return
          description: '`order`, or `return` for a return order placed against an order.'
        parentOrderId:
          type: string
          description: For a return order, the id of the order it was placed against.
        externalReturnId:
          type: string
          description: For an eVital return order, eVital's return id.
        orderNumber:
          type: string
          description: >-
            Display order number (Dawakhana's own number, or eVital's order
            number).
        ipdId:
          type: string
          description: Patient IPD case number.
        status:
          type: string
          enum:
            - CREATED
            - DISPATCHED
            - CANCELLED
            - RETURNED
            - PARTIALLY_RETURNED
          description: Order status.
        createdBy:
          type: string
          description: Id of the user who placed the order.
        createdByName:
          type: string
          description: Name of the user who placed the order.
        rxId:
          type: string
          description: Id of the prescription the order is based on.
        isCollected:
          type: boolean
          description: '`true` when the patient has collected the medicines.'
        collectedBy:
          type: string
          description: Id of the user who marked the order collected.
        collectedByName:
          type: string
          description: Name of the user who marked the order collected.
        collectedAt:
          type: string
          description: Date-time the order was marked collected, as an ISO-8601 string.
        provider:
          type: string
          enum:
            - evital
            - dawakhana
          description: Pharmacy provider fulfilling the order.
        pharmacyId:
          type: string
          description: Id of the fulfilling pharmacy.
        patientName:
          type: string
          description: Name of the patient.
        mobile:
          type: string
          description: Mobile number of the patient.
        patientId:
          type: string
          description: Id of the patient.
        doctorName:
          type: string
          description: Name of the prescribing doctor.
        deliveryType:
          type: string
          enum:
            - pickup
            - delivery
          description: How the medicines reach the patient.
        rxPdfUrl:
          type: string
          description: URL of the prescription PDF.
        notes:
          type: string
          description: Order-level remarks.
        billedTotal:
          type: number
          description: Amount billed for the order, set when it is dispatched.
        fulfilmentType:
          type: string
          enum:
            - FULL
            - PARTIAL
          description: Whether the dispatched order was fulfilled fully or partially.
        dispatchNote:
          type: string
          description: Note added when the order was dispatched.
        dispatchedBy:
          type: string
          description: Id of the user who dispatched the order.
        dispatchedByName:
          type: string
          description: Name of the user who dispatched the order.
        dispatchedAt:
          type: string
          description: Date-time the order was dispatched, as an ISO-8601 string.
        cancelledBy:
          type: string
          description: Id of the user who cancelled the order.
        cancelledByName:
          type: string
          description: Name of the user who cancelled the order.
        cancelledAt:
          type: string
          description: Date-time the order was cancelled, as an ISO-8601 string.
        cancelReason:
          type: string
          description: Reason the order was cancelled.
        returnedBy:
          type: string
          description: Id of the user who returned the order.
        returnedByName:
          type: string
          description: Name of the user who returned the order.
        returnedAt:
          type: string
          description: Date-time the order was returned, as an ISO-8601 string.
        returnReason:
          type: string
          description: Reason the order was returned.
        returnedTotal:
          type: number
          description: Total amount returned against the order.
        createdAt:
          type: string
          description: Created date-time as an ISO-8601 string.
        updatedAt:
          type: string
          description: Last-updated date-time as an ISO-8601 string.
    IpdDawakhanaLine:
      title: IpdDawakhanaLine
      type: object
      properties:
        id:
          type: string
          description: Order line id. Use it as `itemId` when dispatching or returning.
        medicineId:
          type: string
          description: Id of the medicine.
        name:
          type: string
          description: Name of the medicine.
        genericName:
          type: string
          description: Generic (molecule) name of the medicine.
        orderedQty:
          type: number
          description: Quantity ordered.
        directions:
          type: string
          description: Dosage directions.
        fulfilledQty:
          type: number
          description: Quantity given, set at dispatch.
        rate:
          type: number
          description: Price per unit, set at dispatch.
        amount:
          type: number
          description: Line total (`fulfilledQty × rate`), set at dispatch.
        returnedQty:
          type: number
          description: Total quantity returned against this line.
        lineStatus:
          type: string
          enum:
            - PENDING
            - FULFILLED
            - PARTIAL
            - UNAVAILABLE
            - SUBSTITUTED
            - RETURNED
          description: Status of the line.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.