Get store status

GET/me

Return the authenticated Seller’s store status and listing counts.

When to use

Use this operation to get store status.

Endpoint

GET /me

Environment	Base URL
Sandbox	https://api-sandbox.snapcaster.ca/api/v1/marketplace
Production	https://api.snapcaster.ca/api/v1/marketplace

Authentication

• marketplaceApiKey - http bearer. Seller-scoped Marketplace API key, presented as `Authorization: Bearer mp_{sellerCode}_{hex}`. The `mp_{sellerCode}_` prefix identifies the Seller; the trailing hex is the secret. Generated by the Seller and pasted into its Platform.

Request

No parameters.

No request body.

Example

Sandbox is the default. These requests use the contract's canonical field examples.

Generated cURL request - Sandbox

curl --request GET \
  --url 'https://api-sandbox.snapcaster.ca/api/v1/marketplace/me' \
  --header "Authorization: Bearer $MARKETPLACE_API_KEY"

Response

200

Current store status.

Response 200: Ready sandbox store

{
  "success": true,
  "data": {
    "sellerCode": "sandbox-cards",
    "storeName": "Sandbox Cards",
    "currency": "CAD",
    "region": "CA",
    "active": true,
    "vacation": false,
    "counts": {
      "total": 1,
      "matched": 1,
      "unmatched": 0,
      "browsable": 1
    },
    "readiness": {
      "browseEligible": true,
      "effectiveTermsVersion": "2026-07",
      "incompletePrerequisites": []
    }
  }
}

Field	Type	Constraints	Meaning	Example
successrequired	boolean	allowed values: true	Whether the operation completed as requested.	true
datarequired	object	None	The operation or event payload.	{ "sellerCode": "sandbox-cards", "storeName": "Sandbox Cards", "currency": "CAD", "region": "CA", "active": true, "vacation": false, "counts": { "total": 1, "matched": 1, "unmatched": 0, "browsable": 1 }, "readiness": { "browseEligible": true, "effectiveTermsVersion": "2026-07", "incompletePrerequisites": [] } }
data.sellerCoderequired	string	None	Seller Code for the surrounding data record.	sandbox-cards
data.storeNamerequired	string	None	Store Name for the surrounding data record.	Sandbox Cards
data.currencyrequired	string	None	The ISO 4217 currency code used for monetary amounts.	CAD
data.regionrequired	string	None	The market region whose rules and currency apply.	CA
data.activerequired	boolean	None	False while the Seller is suspended.	true
data.vacationrequired	boolean	None	Whether the Seller has temporarily hidden all Listings from Browse.	false
data.countsrequired	object	None	Aggregate counts for the Seller’s Listings.	{ "total": 1, "matched": 1, "unmatched": 0, "browsable": 1 }
data.counts.totalrequired	integer	None	The total number of records in the measured set.	1
data.counts.matchedrequired	integer	None	The number of Listings matched to the canonical catalog.	1
data.counts.unmatchedrequired	integer	None	The number of Listings not yet matched to the canonical catalog.	0
data.counts.browsablerequired	integer	None	Zero while suspended or on vacation.	1
data.readinessrequired	object	None	The Seller’s current Browse-readiness assessment.	{ "browseEligible": true, "effectiveTermsVersion": "2026-07", "incompletePrerequisites": [] }
data.readiness.browseEligiblerequired	boolean	None	Browse Eligible for the surrounding readiness record.	true
data.readiness.effectiveTermsVersionrequired	string	None	Effective Terms Version for the surrounding readiness record.	2026-07
data.readiness.incompletePrerequisitesrequired	array of object	None	Incomplete Prerequisites for the surrounding readiness record.	[]
data.readiness.incompletePrerequisites[].coderequired	string	allowed values: SELLER_ACTIVE, VACATION_DISABLED, SHIPPING_OPTION_CONFIGURED, CONNECTED_ACCOUNT_CANADIAN, PAYOUTS_READY, CURRENT_SELLER_TERMS_ACCEPTED, TAX_PROFILE_COMPLETE, CANADIAN_SHIPMENT_ORIGIN_CONFIRMED, AUTHENTICATOR_ENROLLED, AUTHENTICATOR_RECOVERY_VERIFIED, OPERATOR_REVIEW_APPROVED, SHOP_LINK_ACTIVE, BILLING_TERMS_ACCEPTED	The stable machine-readable code for this result.	SELLER_ACTIVE (generated)
data.readiness.incompletePrerequisites[].messagerequired	string	None	A human-readable explanation of the result.	string (generated)
data.readiness.incompletePrerequisites[].actionrequired	object	None	The corrective action available for this condition.	{ "type": "string", "method": "GET", "href": "string" } (generated)
data.readiness.incompletePrerequisites[].action.typerequired	string	None	The stable kind of the surrounding resource or action.	string (generated)
data.readiness.incompletePrerequisites[].action.methodrequired	string	allowed values: GET, POST, PATCH	The method used to carry out the surrounding action.	GET (generated)
data.readiness.incompletePrerequisites[].action.hrefrequired	string	None	The relative API path for the corrective action.	string (generated)

Errors

Status	Code	Meaning	Do this
401	UNAUTHORIZED	Missing or invalid Marketplace API key (`UNAUTHORIZED`).	Send the Marketplace API key for this Seller as a Bearer token, then retry.

Related

Operations

• Set vacation mode

Concepts

• Credentials and sandbox
• API versioning

Changelog

None.

Schema

Full schema details (28 fields)

Parameters

None.

Request

None.

Response 200 (application/json)

Field	Type	Constraints	Meaning	Example
successrequired	boolean	allowed values: true	Whether the operation completed as requested.	true
datarequired	object	None	The operation or event payload.	{ "sellerCode": "sandbox-cards", "storeName": "Sandbox Cards", "currency": "CAD", "region": "CA", "active": true, "vacation": false, "counts": { "total": 1, "matched": 1, "unmatched": 0, "browsable": 1 }, "readiness": { "browseEligible": true, "effectiveTermsVersion": "2026-07", "incompletePrerequisites": [] } }
data.sellerCoderequired	string	None	Seller Code for the surrounding data record.	sandbox-cards
data.storeNamerequired	string	None	Store Name for the surrounding data record.	Sandbox Cards
data.currencyrequired	string	None	The ISO 4217 currency code used for monetary amounts.	CAD
data.regionrequired	string	None	The market region whose rules and currency apply.	CA
data.activerequired	boolean	None	False while the Seller is suspended.	true
data.vacationrequired	boolean	None	Whether the Seller has temporarily hidden all Listings from Browse.	false
data.countsrequired	object	None	Aggregate counts for the Seller’s Listings.	{ "total": 1, "matched": 1, "unmatched": 0, "browsable": 1 }
data.counts.totalrequired	integer	None	The total number of records in the measured set.	1
data.counts.matchedrequired	integer	None	The number of Listings matched to the canonical catalog.	1
data.counts.unmatchedrequired	integer	None	The number of Listings not yet matched to the canonical catalog.	0
data.counts.browsablerequired	integer	None	Zero while suspended or on vacation.	1
data.readinessrequired	object	None	The Seller’s current Browse-readiness assessment.	{ "browseEligible": true, "effectiveTermsVersion": "2026-07", "incompletePrerequisites": [] }
data.readiness.browseEligiblerequired	boolean	None	Browse Eligible for the surrounding readiness record.	true
data.readiness.effectiveTermsVersionrequired	string	None	Effective Terms Version for the surrounding readiness record.	2026-07
data.readiness.incompletePrerequisitesrequired	array of object	None	Incomplete Prerequisites for the surrounding readiness record.	[]
data.readiness.incompletePrerequisites[].coderequired	string	allowed values: SELLER_ACTIVE, VACATION_DISABLED, SHIPPING_OPTION_CONFIGURED, CONNECTED_ACCOUNT_CANADIAN, PAYOUTS_READY, CURRENT_SELLER_TERMS_ACCEPTED, TAX_PROFILE_COMPLETE, CANADIAN_SHIPMENT_ORIGIN_CONFIRMED, AUTHENTICATOR_ENROLLED, AUTHENTICATOR_RECOVERY_VERIFIED, OPERATOR_REVIEW_APPROVED, SHOP_LINK_ACTIVE, BILLING_TERMS_ACCEPTED	The stable machine-readable code for this result.	SELLER_ACTIVE (generated)
data.readiness.incompletePrerequisites[].messagerequired	string	None	A human-readable explanation of the result.	string (generated)
data.readiness.incompletePrerequisites[].actionrequired	object	None	The corrective action available for this condition.	{ "type": "string", "method": "GET", "href": "string" } (generated)
data.readiness.incompletePrerequisites[].action.typerequired	string	None	The stable kind of the surrounding resource or action.	string (generated)
data.readiness.incompletePrerequisites[].action.methodrequired	string	allowed values: GET, POST, PATCH	The method used to carry out the surrounding action.	GET (generated)
data.readiness.incompletePrerequisites[].action.hrefrequired	string	None	The relative API path for the corrective action.	string (generated)

Error 401 (application/json)

Field	Type	Constraints	Meaning	Example
successrequired	boolean	allowed values: false	Whether the operation completed as requested.	false (generated)
errorrequired	object	None	Structured error information returned when the request cannot be completed.	{ "code": "UNAUTHORIZED", "message": "string" } (generated)
error.coderequired	string	allowed values: UNAUTHORIZED, INVALID_REQUEST, UNSUPPORTED_API_VERSION, SELLER_SOURCE_EXCLUSIVE, BATCH_TOO_LARGE, RATE_LIMITED, ORDER_NOT_FOUND, SELLER_NOT_FOUND, INVALID_TRANSITION, CHECKOUT_IDEMPOTENCY_KEY_REUSED, CHECKOUT_MANUAL_SELLER_UNSUPPORTED, CHECKOUT_SELF_PURCHASE_NOT_ALLOWED, CHECKOUT_SELLER_UNAVAILABLE, CHECKOUT_NOT_FOUND, FEATURE_DISABLED	Stable public error code the Platform can branch on.	UNAUTHORIZED (generated)
error.messagerequired	string	None	A human-readable explanation of the result.	string (generated)
error.details	unknown	None	Additional structured context for diagnosing the result.	{} (generated)