Skip to main content

Show Install (Claim Page)

GET 
//:domain/api/shopify/install/:claimToken

PUBLIC (no authentication). Reveals the Shopify store being connected on the claim page after an App Store cold install.

The opaque claimToken in the path IS the credential — it is minted after OAuth and redirected to app.sku.io/connect/shopify?claim=<token>. This endpoint deliberately exposes only the shop's display identity and lifecycle status; the stashed offline token, scopes, shop email/country, and all internal ids are NEVER returned.

Throttled to 30 req/min to blunt token-guessing.

Response fields (under data):

  • shop_domain (string): the *.myshopify.com domain being connected.
  • shop_name (string): the shop's display name (or a humanized subdomain fallback).
  • status (string): lifecycle status — one of pending_auth, awaiting_claim, claiming, claimed, claim_failed, failed, expired, abandoned.

Returns 404 when the token matches nothing (invalid or already-consumed).

Request​

Responses​

OK

Response Headers
    Content-Type