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

Get the reconciliation report for a manifest

Did we get what you bought? Per-line matched / missing / condition-mismatch status plus anything that arrived attributed to this manifest that you did not list. The manifest.reconciliation.completed webhook fires when this report is finalized, so consuming it can be purely automated.

GET/manifests/{manifest_id}/reconciliation
Authorization
X-API-KeyAPI key · headerrequired
API key in format `sk_*`. Scoped to your partner account; server-side use only.
Path parameters
manifest_idstring<uuid>required
Responses
200The current reconciliation report.
manifest_idstring<uuid>required
generated_atstring<date-time>required
totalsobjectrequired
Show properties
expectedintegerrequired
matchedintegerrequired
missingintegerrequired
unexpectedintegerrequired
condition_mismatchintegerrequired
linesManifestLine[]required
Show properties
Array of ManifestLine
idstring<uuid>required
external_refstring | null
descriptionstringrequired
graderstring | null
cert_numberstring | null
quantityintegerrequired
statusstringrequired
`expected` — not yet arrived; `matched` — arrived and verified; `missing` — reconciliation closed without it arriving; `condition_mismatch` — arrived but intake verification flagged it.
Allowed:expectedmatchedmissingcondition_mismatch
matched_qidsQID[]required
skustring | null
unexpected_itemsobject[]required
Items received and attributed to this manifest that were not on it.
Show properties
Array of object
qidQIDrequired
Vault's canonical identifier for one physical item. It is assigned at intake and remains stable for the item's lifetime.
descriptionstringrequired
cert_numberstring | null
notestring | null
401Missing, invalid, expired, or environment-mismatched API key.
codeErrorCoderequired
Stable machine-readable error vocabulary for v1.
Allowed:validation_errorstate_conflictenvironment_mismatchunsupported_destinationinvalid_api_keynot_foundrate_limited
extraobjectrequired
Structured details such as field errors or SKU availability.
messagestringrequired
Human-readable summary.
404No such resource exists for this partner and environment.
codeErrorCoderequired
Stable machine-readable error vocabulary for v1.
Allowed:validation_errorstate_conflictenvironment_mismatchunsupported_destinationinvalid_api_keynot_foundrate_limited
extraobjectrequired
Structured details such as field errors or SKU availability.
messagestringrequired
Human-readable summary.
429Rate limit exceeded for this API key.
codeErrorCoderequired
Stable machine-readable error vocabulary for v1.
Allowed:validation_errorstate_conflictenvironment_mismatchunsupported_destinationinvalid_api_keynot_foundrate_limited
extraobjectrequired
Structured details such as field errors or SKU availability.
messagestringrequired
Human-readable summary.
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://api.vault.stashtab.gg/v1/manifests/497f6eca-6276-4993-bfeb-53cbbbba6f08/reconciliation" \
  -H "X-API-Key: YOUR_API_KEY"
Response
{
  "manifest_id": "82825e8e-31fc-47d5-83ce-cd926068341e",
  "generated_at": "2019-08-24T14:15:22Z",
  "totals": {
    "expected": 0,
    "matched": 0,
    "missing": 0,
    "unexpected": 0,
    "condition_mismatch": 0
  },
  "lines": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "external_ref": "string",
      "description": "string",
      "grader": "string",
      "cert_number": "string",
      "quantity": 0,
      "status": "expected",
      "matched_qids": [
        "7c9e6679-7425-40de-944b-e07fc1f90ae7"
      ],
      "sku": "string"
    }
  ],
  "unexpected_items": [
    {
      "qid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "description": "string",
      "cert_number": "string",
      "note": "string"
    }
  ]
}