---
title: "Send Order for Employee"
method: POST
path: "/v1/orders/send"
tags: ["Orders"]
---

# Send Order for Employee

`POST /v1/orders/send`

Send an order for a specific employee. Requires API key, login token, and user ID. This endpoint specifically handles employer-to-employee order sending.

## Headers

- `authorization` string, required
- `login-token` string, required
- `user-id` string, required

## Request body

- object
  - `employeeId` string, required — Employee ID to send order to
  - `employerId` string, required — Employer ID sending the order
  - `servicesIds` string[], required — Array of service IDs to include in the order
  - `providersIds` object[], required — Array mapping each service (by index) to a provider; serviceId optional
    - `serviceId` string
    - `providerId` string, required
  - `quantities` object — Service ID to quantity mapping
  - `providerId` string — Single provider ID (shortcut when all services map to one provider)
  - `brandId` string — Brand ID for branded orders
  - `dueDate` string — Due date for the order (date or date-time ISO string)
  - `dueDates` string[] — Array of due dates per service
  - `providerCreated` boolean — Whether this order is being created by a provider (affects permission checking)
  - `metadata` object — Optional arbitrary metadata to store on the order (non-indexed passthrough, <=10KB when JSON stringified)
  - `expirationDate` string — Expiration date for the order (date or date-time ISO string)
  - `priority` 'normal' | 'high' — Order priority level

## Response `200`

Order sent successfully (single or split)

- union — Order sent successfully (single or split)
  - object
    - `success` true, required
    - `orderId` string, required
    - `orderNumber` string, required
    - `message` string
    - `unavailableServices` object[] — Services that could not be included in the order
      - `serviceId` string, required
      - `serviceName` string
      - `reason` string, required — Why the service was unavailable
    - `partialSuccess` boolean — True when some services were unavailable but order was still created
  - object
    - `success` true, required
    - `status` 'split', required
    - `message` string
    - `orderResults` object[], required
      - `orderId` string, required
      - `orderNumber` string, required
      - `providerId` string, required
    - `unavailableServices` object[] — Services that could not be included in any order
      - `serviceId` string, required
      - `serviceName` string
      - `reason` string, required — Why the service was unavailable
    - `partialSuccess` boolean — True when some services were unavailable but orders were still created

## Other responses

- `400` — Bad request (validation error)
- `401` — Authentication error (missing/invalid API key or login credentials)
- `403` — Access denied (authenticated, but no user context or insufficient permissions)
- `500` — Server error

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/versions/e6e553c2594a/schema)