Skip to content
Stashtab Docs
Esc
↑↓navigate↵open⌘Jpreview

Get multiple orders

Reads 1–20 known order IDs in request order using the same customer-safe recipient, status and tracking facts as each individual order read. Duplicate IDs repeat the same result and are read once. Foreign or missing IDs return missing. A provider-unavailable item returns unavailable with retryAfterSeconds when validated timing is available; wait that long before polling that ID again. An available order can still have null current facts when the warehouse no longer reports it. Read-capable organization keys may use this operation within their immutable organization and mode. Provider budgets and current authority still apply. An available redemption includes the same packingException as getOrder, so a batch read is the discovery path for packing exceptions: poll every redemption that has not shipped at least once an hour.

POST/v1/organizations/{orgId}/orders/batch
Authorization
AuthorizationBasic auth · headerrequired

Registered confidential integration credentials. Keep the secret server-side.

or
CookieAPI key · headerrequired

Console-managed Vault session cookie; secure cookie naming may vary by environment.

or
AuthorizationBearer token (Vault organization API key) · headerrequired

Organization-owned credential with immutable mode and Read-only or Read/write permissions. Only explicitly declared ordinary customer operations accept it. Test business access refuses until shared Test composition is available; no staff, team, key-management or protocol authority is granted.

Path parameters
orgIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
Request body
requiredapplication/json
orderIdsstring[]required
min items 1 · max items 20
Responses
200

Success

dataobjectrequired
Show properties
itemsobject[]required
Show properties
Array of object
One of:
object
orderobjectrequired
Show properties
customerLabelstring | nullrequired
idstringrequired
kindstringrequired
Allowed:ordinaryredemptionreshipship_back
receiptobjectrequired
Show properties
operationIdstring | nullrequired
recordedAtstringrequired
visibleOrderNumberstring | nullrequired
cancellationobject | null
Show properties
Any of:
object
deadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
eligiblebooleanrequired
null
null
currentobject | nullrequired
Show properties
Any of:
object
insuranceobject | null
Show properties
Any of:
object
insuredbooleanrequired

Whether the order asks the warehouse to insure its one parcel. False is the explicit no-additional-insurance choice.

insuredValueobject | nullrequired

Declared value to insure, independent of goods and customs values. Null when not insured.

Show properties
Any of:
object
amountstringrequired
currencystringrequired
null
null
labelobject | nullrequired

Null until the warehouse buys the one label for this order, or when the order has more than one active shipment.

Show properties
Any of:
object
insuredboolean | nullrequired

Whether the warehouse's label reports additional coverage. Null when the label does not report it.

insuredValueobject | nullrequired
Show properties
Any of:
object
amountstringrequired
currencystringrequired
null
null
providerstring | nullrequired
Show properties
Any of:
string
string
null
null
null
null
providerstring | nullrequired

Coverage provider. carrier is the carrier's declared-value coverage.

Show properties
Any of:
string
string
null
null
null
null
requestedDeliveryConfirmationstring | null
Show properties
Any of:
string
string
null
null
orderDatestring | nullrequired
providerOrderNumberstring | nullrequired
recipientNamestring | nullrequired
statusstringrequired
Allowed:on_holdreadyshippedcanceledunknown
trackingobject[]required
Show properties
Array of object
deliveryConfirmationstring | null
Show properties
Any of:
string
string
null
null
carrierstring | nullrequired
numberstringrequired
shipDatestring | nullrequired
parcelEvidenceobject
Show properties
allParcelsCollectedboolean | nullrequired
coveragestringrequired
Allowed:completeincomplete
membershipObservedAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
statestringrequired
Allowed:confirmedpendingincompletestaleunavailableunknown
parcelsobject[]required
Show properties
Array of object
idstringrequired
carrierstring | nullrequired
numberstringrequired
statestringrequired
Allowed:confirmedpendingunavailableunknown
eventobject | nullrequired
Show properties
Any of:
object
detailCodestringrequired
occurredAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
reportedAtstring | nullrequired
null
null
detailCodestring | nullrequired
observedAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
establishedAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
refreshstringrequired
Allowed:currentunavailableunknownstale
simulatedbooleanrequired
customerNotesstring | nullrequired
holdUntilDatestring | nullrequired
itemsobject[]required
Show properties
Array of object
declaredUnitValuestring | null
namestring | nullrequired
productIdstring | null
quantityinteger | nullrequired
Show properties
Any of:
integer
integer
null
null
skustring | nullrequired
unitPricestring | null
recipientobject | nullrequired
Show properties
Any of:
object
citystring | nullrequired
companystring | nullrequired
countrystring | nullrequired
emailstring | nullrequired
namestring | nullrequired
phonestring | nullrequired
postalCodestring | nullrequired
statestring | nullrequired
street1string | nullrequired
street2string | nullrequired
null
null
revisionstringrequired
requestedShippingServicestring | nullrequired
null
null
packingExceptionobject | null

Redemption cards held while packing, each with its offer, response deadline and outcome. Null when no card was held.

Show properties
Any of:
object
estimateobject | nullrequired
Show properties
Any of:
object
amountstring | nullrequired

Estimated total in currency units. Null when a component is not yet known; unknown is never reported as zero.

asOfstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
basisstringrequired
completebooleanrequired

True only when every affected unit is applied and the amount is known. False while any unit is not applied, because that card is priced as ordered, and when the amount is null.

componentsobject[]required
Show properties
Array of object
amountstring | nullrequired
codestringrequired
currencystringrequired
min length 3 · max length 3
revisionintegerrequired
min 1 · max 9007199254740991
null
null
idstringrequired
recordedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
resolvedAtstring<date-time> | nullrequired
Show properties
Any of:
string<date-time>
string<date-time>
null
null
revisionintegerrequired
min 1 · max 9007199254740991
statusstringrequired

held keeps the order from shipping until every unit settles.

Allowed:heldresolved
unitsobject[]required
Show properties
Array of object
decisionobject | nullrequired
Show properties
Any of:
object
answerstringrequired
Allowed:accept_offerremove_card
decidedAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
offerRevisionintegerrequired
min 1 · max 9007199254740991
operationIdstring | nullrequired

Operation ID of the answer that made this decision. Retry or recover an answer by this ID. Null when the warehouse or the deadline decided.

sourcestringrequired

answer is the customer's own answer; warehouse is a decision the warehouse recorded on the customer's instruction; deadline_default removes the card when the response window closes without one.

Allowed:answerwarehousedeadline_default
null
null
foundConditionstring | nullrequired
Show properties
Any of:
string
string
null
null
idstringrequired
lineIndexintegerrequired
min 0 · max 9007199254740991
offerobjectrequired
Show properties
conditionstring | nullrequired

Condition of the offered replacement card, when graded.

Show properties
Any of:
string
string
null
null
idstringrequired
kindstringrequired

replacement offers one reserved card; no_offer means the only choice is removing the card.

Allowed:replacementno_offer
productstring | nullrequired

The SKU of the offered replacement card, or null for no_offer.

readableAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
responseDeadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
revisionintegerrequired
min 1 · max 9007199254740991
orderedobjectrequired
Show properties
conditionstring | nullrequired
Show properties
Any of:
string
string
null
null
productstringrequired
skustring | nullrequired
outcomestringrequired
Allowed:awaiting_answerreceivedpendingappliedrefused
packCardOrdinalinteger | nullrequired
Show properties
Any of:
integer
integer
null
null
reasonstringrequired
Allowed:condition_mismatchmissingdamaged
responseDeadlineAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
unitIndexintegerrequired
min 0 · max 9007199254740991
null
null
sourceOrderIdstring | nullrequired
orderIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
statusstringrequired
object
orderIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
statusstringrequired
object
orderIdstringrequired
min length 1 · max length 128 · matches ^[A-Za-z0-9_-]+$
retryAfterSecondsinteger
max 9007199254740991
statusstringrequired
metaobjectrequired
Show properties
requestIdstringrequired
default

Error

errorobjectrequired
Show properties
codestringrequired
Allowed:forbiddeninternal_errornot_foundprovider_data_invalidprovider_outcome_unknownprovider_unavailablerate_limitedstate_conflictunauthenticatedvalidation_errorwarehouse_not_ready
fieldsobject[]
Show properties
Array of object
codestringrequired
messagestringrequired
pathstringrequired
messagestringrequired
operationIdstring
metaobjectrequired
Show properties
requestIdstringrequired
Request
curl -X POST '/v1/organizations/org_example/orders/batch' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "orderIds": [
    "order_example_1",
    "order_example_missing"
  ]
}'
Response
{
  "data": {
    "items": [
      {
        "order": {
          "customerLabel": null,
          "id": "order_example_1",
          "kind": "ordinary",
          "receipt": {
            "operationId": null,
            "recordedAt": "2026-11-05T15:00:00.000Z"
          },
          "visibleOrderNumber": null,
          "current": null,
          "sourceOrderId": null
        },
        "orderId": "order_example_1",
        "status": "available"
      },
      {
        "orderId": "order_example_missing",
        "status": "missing"
      }
    ]
  },
  "meta": {
    "requestId": "example-batchGetOrders"
  }
}

Was this page helpful?