> ## 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.

# Get Order

> 
### Overview

This API returns a single **medicine order** of your workspace with its full detail. On top of the fields returned by List Orders it includes:

- `lineItems` — the ordered medicines, in the same shape for every provider (for eVital orders these are fetched live from eVital).
- `pharmacyName` — the name of the fulfilling pharmacy.
- `returns` — for an order (`kind: order`), the return orders placed against it.

For a return order (`kind: return`), `lineItems` lists the returned medicines.

Returns `404` with `Order not found` when the `order_id` does not exist or belongs to another workspace.



## OpenAPI

````yaml get /ipd/v1/service/orders/{order_id}
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/orders/{order_id}:
    get:
      tags:
        - IPD API
      summary: Get Order
      description: >-

        ### Overview


        This API returns a single **medicine order** of your workspace with its
        full detail. On top of the fields returned by List Orders it includes:


        - `lineItems` — the ordered medicines, in the same shape for every
        provider (for eVital orders these are fetched live from eVital).

        - `pharmacyName` — the name of the fulfilling pharmacy.

        - `returns` — for an order (`kind: order`), the return orders placed
        against it.


        For a return order (`kind: return`), `lineItems` lists the returned
        medicines.


        Returns `404` with `Order not found` when the `order_id` does not exist
        or belongs to another workspace.
      operationId: GetIpdOrder
      parameters:
        - name: auth
          in: header
          required: true
          schema:
            type: string
          example: >-
            eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiX2lkIjoiMTIzNDU2IiwiY2xpZW50X2lkIjoiNzg5MCIsImV4dHJhX2ZpZWxkIjoiZXh0cmFfZmllbGRfZGF0YSJ9.q9KzBI6f4l3OyM_EkB5Quq0l9EEMFh5JS-fx3F_PHUM
        - name: order_id
          in: path
          description: Id of the order.
          required: true
          style: simple
          schema:
            type: string
          example: 66f1cd07e4b0a1b2c3d4ef0a
      responses:
        '200':
          description: OK — the order with its detail.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/IpdOrderDetail'
              example:
                success: true
                data:
                  id: 66f1cd07e4b0a1b2c3d4ef0a
                  admissionId: a1b2c3d4-5678-90ab-cdef-1234567890ab
                  kind: order
                  orderNumber: DW-7Q2K9F3M
                  ipdId: IPD-2026-0042
                  status: DISPATCHED
                  createdBy: '161467756044203'
                  createdByName: Vivek Sharma
                  isCollected: false
                  provider: dawakhana
                  patientName: Ravi Kumar
                  billedTotal: 45
                  fulfilmentType: FULL
                  dispatchedAt: '2026-10-07T12:40:00.000Z'
                  createdAt: '2026-10-07T12:10:00.000Z'
                  updatedAt: '2026-10-07T12:40:00.000Z'
                  pharmacyName: In-house Pharmacy
                  lineItems:
                    - name: Paracetamol 500mg Tablet
                      genericName: Paracetamol
                      medicineId: med-paracetamol-500
                      orderedQty: 10
                      fulfilledQty: 10
                      rate: 4.5
                      amount: 45
                      directions: 1 tablet every 6 hours
                      status: FULFILLED
                  returns: []
        '400':
          description: >-
            Bad Request — the `order_id` is not a valid id, or the order detail
            could not be loaded (for example eVital did not respond).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpdServiceFailure'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpdServiceError'
        '404':
          description: Not Found — the order was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpdServiceFailure'
              example:
                success: false
                error: Order not found
      deprecated: false
components:
  schemas:
    IpdOrderDetail:
      title: IpdOrderDetail
      allOf:
        - $ref: '#/components/schemas/IpdOrder'
        - type: object
          properties:
            lineItems:
              type: array
              description: The ordered (or, for a return order, returned) medicines.
              items:
                $ref: '#/components/schemas/IpdOrderLineItem'
            pharmacyName:
              type: string
              description: Name of the fulfilling pharmacy.
            returns:
              type: array
              description: For an order, the return orders placed against it.
              items:
                $ref: '#/components/schemas/IpdOrder'
    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.
    IpdOrderLineItem:
      title: IpdOrderLineItem
      type: object
      properties:
        name:
          type: string
          description: Name of the medicine.
        genericName:
          type: string
          description: Generic (molecule) name of the medicine.
        medicineId:
          type: string
          description: Id of the medicine.
        image:
          type: string
          description: Medicine image URL, when the provider has one.
        orderedQty:
          type: number
          description: Quantity ordered.
        fulfilledQty:
          type: number
          description: Quantity actually fulfilled.
        returnedQty:
          type: number
          description: Quantity returned against this line, when tracked.
        rate:
          type: number
          description: Price per unit.
        mrp:
          type: number
          description: Maximum retail price per unit, when known.
        amount:
          type: number
          description: Line total (rate × fulfilled quantity).
        directions:
          type: string
          description: Dosage directions.
        status:
          type: string
          description: >-
            Line status from the provider, when tracked (for example FULFILLED,
            PARTIAL or UNAVAILABLE).

````

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