---
title: "Receive a known package at a hub, including unrouted packages"
method: POST
path: "/v1/hub-scanning/receipts"
tags: ["Hub Scanning"]
---

# Receive a known package at a hub, including unrouted packages

`POST /v1/hub-scanning/receipts`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/hub-scanning/receipts`
- Auth: none declared

## Request body

- HubReceiptRequest
  - `eventId` string, uuid, required
  - `capturedAt` string, date-time, required
  - `deviceId` string, required
  - `reason` string, nullable
  - `barcode` string, required
  - `hubId` string, required
  - `serviceDate` string, date, required
  - `condition` 'first_quality' | 'damage_pending'

## Response `200`

OK

- HubReceiptResult
  - `eventId` string, uuid, required
  - `barcode` string, required
  - `outcome` 'received' | 'already_received' | 'damage_reported' | 'unknown_barcode' | 'ambiguous_barcode' | 'on_hold', required
  - `order` HubOrderRead
    - `orderId` string, required
    - `hubId` string, required
    - `serviceDate` string, date, required
    - `routeId` string, nullable
    - `barcode` string, required
    - `version` string, required
    - `receiptStatus` 'pending' | 'received' | 'shortage', required
    - `condition` 'not_assessed' | 'first_quality' | 'damage_pending' | 'damaged', required
    - `disposition` 'active' | 'lost_in_hub' | 'closed' | 'donated', required
    - `receivedAt` string, date-time, nullable
    - `receivedBy` string, nullable
    - `conditionReason` string, nullable
    - `staged` boolean
    - `loaded` boolean
    - `actualRouteId` string, nullable
    - `loadBlockedReason` string, nullable
    - `history` HubOrderHistory[]
      - `eventId` string, uuid, required
      - `operation` 'receive' | 'report_damage' | 'clear_damage' | 'confirm_damage' | 'confirm_damage_donate' | 'mark_shortage' | 'reattempt' | 'mark_lost' | 'close_missing', required
      - `capturedAt` string, date-time, required
      - `receivedAt` string, date-time, required
      - `actorId` string, required
      - `reason` string, nullable
    - `allowedOperations` HubOperation[]
  - `serverReceivedAt` string, date-time, required
  - `loadBlockedReason` string, nullable

## Other responses

- `422`: Unprocessable Content

---

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