---
title: "Upload results for an order"
method: POST
path: "/v1/orders/{orderId}/upload-results"
tags: ["Orders"]
---

# Upload results for an order

`POST /v1/orders/{orderId}/upload-results`

## Request

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

Upload test results for a specific order item. Supports both existing fileIds and base64 encoded files. Requires order access code and employee verification.

## Path parameters

- `orderId` string, required

## Request body

- object
  - `orderAccessCode` string, required
  - `serviceId` string, required
  - `captchaToken` string, required
  - `lastName` string
  - `dob` string: Date of birth in YYYY-MM-DD format
  - `fileIds` string[]
  - `files` object[]
    - `name` string, required
    - `type` string, required
    - `base64` string, required

## Response `200`

Default Response

- object
  - `success` boolean
  - `message` string

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-10-16** `a8bcbdf02e33`: 2 breaking, 1 warning
  - the request property `captchaToken` became required
  - the `captchaToken` request property's minLength was increased from `0` to `1`
  - removed the optional property `fileIds` from the response with the `200` status
- **2026-09-11** `84d0927cff07`: 3 info
  - the request property `captchaToken` became optional
  - the `captchaToken` request property's minLength was decreased from `1` to `0`
  - added the optional property `fileIds` to the response with the `200` status
- **2026-06-17** `1fa6a490c5b4`: 2 warning
  - the `fileIds/items/` request property's maxLength was set to `128`
  - the `files/items/base64` request property's maxLength was set to `20971520`
- **2025-10-05** `28d439490b5e`: 1 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2025-10-05** `3c4bce10c1fe`: 1 info
  - the endpoint scheme security `ApiKeyAuth` was removed from the API

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/orders/:orderId/upload-results/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)