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

# Send Order for Employee

`POST /v1/orders/send`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/orders/send`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/orders/send/post.ts> (a function with typed inputs; its response is checked against the schema)

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)
  - `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

## Changes

- **2026-10-16** `a8bcbdf02e33`: 3 warning, 1 info
  - removed the request property `acknowledgedDuplicateOrderIds`
  - removed the request property `bundleIds`
  - removed the request property `expirationDate`
  - removed the non-success response with the status `409`
- **2026-09-04** `cbee4fee80fb`: 1 info
  - added the new optional request property `bundleIds`
- **2026-08-21** `ae97a9add0ba`: 2 info
  - added the new optional request property `acknowledgedDuplicateOrderIds`
  - added the non-success response with the status `409`
- **2026-06-03** `088f5a47edc2`: 1 info
  - added the new optional request property `expirationDate`
- **2026-02-18** `efcb45ec0e67`: 1 info
  - added the new optional request property `priority`

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/orders/send/post.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)