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

List intake events

Everything that completed digitization in a time window — e.g. “all my intakes for today”. Each entry carries the same payload as the item.intake.completed webhook, so pull and push are interchangeable.

GET/intakes
Authorization
X-API-KeyAPI key · headerrequired
API key in format `sk_*`. Scoped to your partner account; server-side use only.
Query parameters
pageinteger
Page number (1-based).
min 1 · default: 1
page_sizeinteger
Items per page.
min 1 · max 250 · default: 25
intake_afterstring<date-time>
Only intakes completed at or after this time.
intake_beforestring<date-time>
Only intakes completed before this time.
manifest_idstring<uuid>
Only intakes matched to lines of this manifest.
cert_numberstring
Exact grader certification number.
Responses
200Paginated intake events, newest first.
page_sizeintegerrequired
Requested page size.
countintegerrequired
Items in this page.
totalintegerrequired
Total items across all pages.
current_page_numberintegerrequired
next_page_numberinteger | null
nextstring<uri> | null
URL of the next page.
previousstring<uri> | null
previous_page_numberinteger | null
resultsIntakeEvent[]required
Show properties
Array of IntakeEvent
qidQIDrequired
Vault's canonical identifier for one physical item. It is assigned at intake and remains stable for the item's lifetime.
intake_atstring<date-time>required
manifest_idstring<uuid> | null
Manifest this intake was attributed to, if any.
manifest_line_idstring<uuid> | null
Expected-manifest line this item matched, if any.
condition_flagsstring[]required
Verification flags raised at intake (e.g. `cracked_case`, `label_mismatch`). Empty when the item verified clean.
itemItemrequired
Show properties
One of:
GradedSlabItem
active_fulfillment_idstring<uuid> | null
The fulfillment currently holding this item, if any.
categorystring
Item category.
external_refstring | null
Your identifier for this item, echoed from the manifest line when matched.
image_assetsImageAsset[]required
Per-item intake imagery for graded slabs or catalog imagery for product items.
Show properties
Array of ImageAsset
variantstringrequired
Which view of the slab this asset shows.
Allowed:frontbacklabel
urlstring<uri>required
Permanent CDN URL.
widthintegerrequired
Pixel width.
heightintegerrequired
Pixel height.
formatstringrequired
Allowed:webpjpegpng
intake_atstring<date-time>required
When the item completed intake and entered the system.
manifest_line_idstring<uuid> | null
The expected-manifest line this item matched at intake, if any.
model_3dstring<uri> | null
Reserved for future render assets and always null today so clients can keep a stable schema.
namestringrequired
Display name, clean enough to show to your end customers.
qidQIDrequired
Vault's canonical identifier for one physical item. It is assigned at intake and remains stable for the item's lifetime.
setstring | null
card_numberstring | null
skustringrequired
Warehouse SKU. Product items reference the partner catalog; graded slabs use their graded-item SKU.
statusItemStatusrequired
Custody lifecycle for one physical item. New statuses may be added compatibly within v1.
Allowed:receiveddigitizedavailablein_fulfillmentin_transitdeliveredpending_transferreleasedwithdrawn
typestringrequired
Allowed:graded_slab
updated_atstring<date-time>required
cert_numberstringrequired
Grader certification number.
gradestringrequired
graderstringrequired
Grading company.
ProductItem
active_fulfillment_idstring<uuid> | null
The fulfillment currently holding this item, if any.
categorystring
Item category.
external_refstring | null
Your identifier for this item, echoed from the manifest line when matched.
image_assetsImageAsset[]required
Per-item intake imagery for graded slabs or catalog imagery for product items.
Show properties
Array of ImageAsset
variantstringrequired
Which view of the slab this asset shows.
Allowed:frontbacklabel
urlstring<uri>required
Permanent CDN URL.
widthintegerrequired
Pixel width.
heightintegerrequired
Pixel height.
formatstringrequired
Allowed:webpjpegpng
intake_atstring<date-time>required
When the item completed intake and entered the system.
manifest_line_idstring<uuid> | null
The expected-manifest line this item matched at intake, if any.
model_3dstring<uri> | null
Reserved for future render assets and always null today so clients can keep a stable schema.
namestringrequired
Display name, clean enough to show to your end customers.
qidQIDrequired
Vault's canonical identifier for one physical item. It is assigned at intake and remains stable for the item's lifetime.
setstring | null
card_numberstring | null
skustringrequired
Warehouse SKU. Product items reference the partner catalog; graded slabs use their graded-item SKU.
statusItemStatusrequired
Custody lifecycle for one physical item. New statuses may be added compatibly within v1.
Allowed:receiveddigitizedavailablein_fulfillmentin_transitdeliveredpending_transferreleasedwithdrawn
typestringrequired
Allowed:product
updated_atstring<date-time>required
cert_numberstring | nullrequired
Allowed:null
gradestring | nullrequired
Allowed:null
graderstring | nullrequired
Allowed:null
400Validation failed.
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.
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.
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/intakes" \
  -H "X-API-Key: YOUR_API_KEY"
Response
{
  "page_size": 0,
  "count": 0,
  "total": 0,
  "current_page_number": 0,
  "next_page_number": 0,
  "next": "http://example.com",
  "previous": "http://example.com",
  "previous_page_number": 0,
  "results": [
    {
      "qid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "intake_at": "2019-08-24T14:15:22Z",
      "manifest_id": "82825e8e-31fc-47d5-83ce-cd926068341e",
      "manifest_line_id": "e1bcc1ed-284d-4866-b8d7-5633b41d43ea",
      "condition_flags": [
        "string"
      ],
      "item": {
        "active_fulfillment_id": "bcb367cb-b94e-4e20-973d-e3de4f574083",
        "category": "sports-card",
        "external_ref": "string",
        "image_assets": [
          {
            "variant": "front",
            "url": "http://example.com",
            "width": 0,
            "height": 0,
            "format": "webp"
          }
        ],
        "intake_at": "2019-08-24T14:15:22Z",
        "manifest_line_id": "e1bcc1ed-284d-4866-b8d7-5633b41d43ea",
        "model_3d": "http://example.com",
        "name": "2018 Panini Prizm Luka Doncic",
        "qid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "set": "2018-19 Panini Prizm",
        "card_number": "280",
        "sku": "string",
        "status": "available",
        "type": "graded_slab",
        "updated_at": "2019-08-24T14:15:22Z",
        "cert_number": "string",
        "grade": "string",
        "grader": "string"
      }
    }
  ]
}