---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Read one known order within the current… Reference for the GET
    /v1/organizations/{orgId}/orders/{orderId} endpoint in the Stashtab Vault
    Warehouse API.
sidebar:
  label: Get an order
  badge: GET
title: Get an order
type: openapi-operation
---
Read one known order within the current organization and mode, including permitted recipient, line, status and tracking facts. Current provider facts can be null when the warehouse no longer reports the order. current.requestedDeliveryConfirmation reports the provider order request. Each tracking entry reports deliveryConfirmation only from that exact purchased shipment; null or an absent field means unknown. A request, label or signature option does not prove recipient identity or physical delivery. For a Live redemption, cancellation.deadlineAt is the persisted server deadline and cancellation.eligible reflects the current hold policy: an untouched held order is eligible only while now &lt; deadlineAt. The exact deadline is closed. Cancellation rechecks current provider identity, revision and shipment state; eligibility is not a provider or physical-workflow guarantee. A historical redemption without a recorded hold returns cancellation: null; ordinary orders omit it. The creation receipt preserves its original creation-time eligibility on replay and never extends the deadline. Test redemptions also expose their server-owned cancellation deadline and current time/state eligibility; these facts do not grant cancellation permission. Manual Test release is unavailable before the deadline. An early release returns 409 state_conflict explaining the open window. Refresh after expiry to review manual release; expiry alone does not release the order. Additive current.parcelEvidence confirms allParcelsCollected only for a complete active outbound parcel set with qualifying physical carrier evidence for every parcel. Historical collection and current refresh health remain separate; unknown, incomplete, stale or unavailable evidence returns no affirmative conclusion. Label creation, electronic advice, shipDate and shipped status do not prove collection. Test events are explicitly simulated. Missing or foreign orders are not found. A redemption also returns packingException: null when no card was held while packing, otherwise the held cards; ordinary orders omit the field. Each unit is one physical copy with a stable id, its zero-based lineIndex and unitIndex (duplicate copies of one card are separate units), the ordered product, SKU and condition, the reason (condition_mismatch, missing or damaged) and the condition found. offer is the current offer: id, revision, kind replacement (one reserved card with its product and condition) or no_offer (removal is the only answer), readableAt and responseDeadlineAt, 168 hours after readableAt. decision is null until the card is answered, decided by the warehouse on your instruction or defaulted to remove_card at the deadline; it carries the answer, source, offerRevision, decidedAt and the answer operationId. outcome is awaiting_answer, received, pending, applied or refused. Only applied is a confirmed effect: an applied remove_card is a confirmed removal that you can use as evidence to restore that card's token, and an applied accept_offer ships the offered card. received and pending are not confirmed. The order lines keep the ordered content; apply the applied unit decisions to them for the current contents. status stays held, and the order cannot ship, until every unit is applied and any purchased label is reconciled; resolved lifts the hold, and an order with no remaining cards is cancelled. estimate is the current revised customer estimate with its revision, asOf, components and complete flag. It is not a charge or an invoice; an amount of null means unknown and is never zero. A higher estimate needs no approval. Actual charges come from actual work and carrier costs through your ordinary invoices.

`GET /v1/organizations/{orgId}/orders/{orderId}`

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "customerLabel": "string",
    "id": "string",
    "kind": "ordinary",
    "receipt": {
      "operationId": "string",
      "recordedAt": "string"
    },
    "visibleOrderNumber": "string",
    "cancellation": {
      "deadlineAt": "2019-08-24T14:15:22Z",
      "eligible": true
    },
    "current": {
      "insurance": {
        "insured": true,
        "insuredValue": {
          "amount": "string",
          "currency": "string"
        },
        "label": {
          "insured": true,
          "insuredValue": {
            "amount": "string",
            "currency": "string"
          },
          "provider": "carrier"
        },
        "provider": "carrier"
      },
      "requestedDeliveryConfirmation": "none",
      "orderDate": "string",
      "providerOrderNumber": "string",
      "recipientName": "string",
      "status": "on_hold",
      "tracking": [
        {
          "deliveryConfirmation": "none",
          "carrier": "string",
          "number": "string",
          "shipDate": "string"
        }
      ],
      "parcelEvidence": {
        "allParcelsCollected": true,
        "coverage": "complete",
        "membershipObservedAt": "2019-08-24T14:15:22Z",
        "state": "confirmed",
        "parcels": [
          {
            "id": "string",
            "carrier": "string",
            "number": "string",
            "state": "confirmed",
            "event": {
              "detailCode": "string",
              "occurredAt": "2019-08-24T14:15:22Z",
              "reportedAt": "string"
            },
            "detailCode": "string",
            "observedAt": "2019-08-24T14:15:22Z",
            "establishedAt": "2019-08-24T14:15:22Z",
            "refresh": "current",
            "simulated": true
          }
        ]
      },
      "customerNotes": "string",
      "holdUntilDate": "string",
      "items": [
        {
          "declaredUnitValue": "string",
          "name": "string",
          "productId": "string",
          "quantity": -9007199254740991,
          "sku": "string",
          "unitPrice": "string"
        }
      ],
      "recipient": {
        "city": "string",
        "company": "string",
        "country": "string",
        "email": "string",
        "name": "string",
        "phone": "string",
        "postalCode": "string",
        "state": "string",
        "street1": "string",
        "street2": "string"
      },
      "revision": "string",
      "requestedShippingService": "string"
    },
    "packingException": {
      "estimate": {
        "amount": "string",
        "asOf": "2019-08-24T14:15:22Z",
        "basis": "estimate",
        "complete": true,
        "components": [
          {
            "amount": "string",
            "code": "string"
          }
        ],
        "currency": "str",
        "revision": 1
      },
      "id": "string",
      "recordedAt": "2019-08-24T14:15:22Z",
      "resolvedAt": "2019-08-24T14:15:22Z",
      "revision": 1,
      "status": "held",
      "units": [
        {
          "decision": {
            "answer": "accept_offer",
            "decidedAt": "2019-08-24T14:15:22Z",
            "offerRevision": 1,
            "operationId": "string",
            "source": "answer"
          },
          "foundCondition": "nm",
          "id": "string",
          "lineIndex": 0,
          "offer": {
            "condition": "nm",
            "id": "string",
            "kind": "replacement",
            "product": "string",
            "readableAt": "2019-08-24T14:15:22Z",
            "responseDeadlineAt": "2019-08-24T14:15:22Z",
            "revision": 1
          },
          "ordered": {
            "condition": "nm",
            "product": "string",
            "sku": "string"
          },
          "outcome": "awaiting_answer",
          "packCardOrdinal": 1,
          "reason": "condition_mismatch",
          "responseDeadlineAt": "2019-08-24T14:15:22Z",
          "unitIndex": 0
        }
      ]
    },
    "sourceOrderId": "string"
  },
  "meta": {
    "requestId": "string"
  }
}
```
