RevKeenDocs
StatusSupport
API Reference
🔗 CheckoutStorefront

Get storefront integration status

Readiness report for the Cart/headless-storefront setup: activation, managed keys, registered origins, product-read readiness, webhook health, and availability tracking. CART_DISABLED / KEYS_MISSING / ORIGIN_MISSING / PRODUCT_READ_UNAVAILABLE are fail-level; WEBHOOK_MISSING / WEBHOOK_UNREACHABLE are warn-level. Never returns key material.

GET/storefront/status

Readiness report for the Cart/headless-storefront setup: activation, managed keys, registered origins, product-read readiness, webhook health, and availability tracking. CART_DISABLED / KEYS_MISSING / ORIGIN_MISSING / PRODUCT_READ_UNAVAILABLE are fail-level; WEBHOOK_MISSING / WEBHOOK_UNREACHABLE are warn-level. Never returns key material.

Related endpoints

  • GET /storefront/products — List storefront products
  • GET /storefront/products/{productId} — Get a storefront product
  • GET /storefront/origins — List storefront origins
  • POST /storefront/origins — Register a storefront origin
  • DELETE /storefront/origins/{originId} — Remove a storefront origin

Common errors

  • 401 authentication_error — missing, invalid, expired, or revoked credential. Codes: authentication_failed, invalid_api_key, expired_api_key, api_key_revoked, session_invalid, merchant_required. Carries a WWW-Authenticate: Bearer challenge.
  • 403 authorization_error — the caller is identified but the action is denied. Codes include insufficient_permissions, ip_not_allowed, merchant_mismatch, and origin_not_allowed.

Authorization

x-api-key<token>

Your RevKeen merchant API key. Create and manage keys in Dashboard → Settings → Developer. Use rk_sandbox_* for staging/test and rk_live_* for production. The same key may be sent as Authorization: Bearer <key> if that suits your HTTP client better. A missing, invalid, expired, or revoked key returns 401 with a WWW-Authenticate: Bearer challenge; a valid key without the required scope returns 403.

In: header

Response Body

application/json

application/json

application/json

application/json

Stuck on an error response? Ask the RevKeen assistant to explain it.
curl -X GET "https://api.revkeen.com/v2/storefront/status" \
  -H "x-api-key: $REVKEEN_API_KEY"

Synthetic documentation data, validated against the response schema; not a live API result.

{  "data": {    "object": "storefront_status",    "ready": true,    "checks": [      {        "id": "cart_enabled",        "status": "pass",        "code": "CART_DISABLED",        "message": "string",        "next_action": "string"      }    ],    "cart": {      "enabled": true,      "profile": "string"    },    "keys": {      "publishable": {        "present": true,        "active": true,        "created_at": "2019-08-24T14:15:22Z",        "last_used_at": "2019-08-24T14:15:22Z"      },      "secret": {        "present": true,        "active": true,        "created_at": "2019-08-24T14:15:22Z",        "last_used_at": "2019-08-24T14:15:22Z"      }    },    "origins": {      "count": 0,      "origins": [        "string"      ]    },    "product_read": {      "active_products": 0,      "priced_products": 0,      "ready": true    },    "webhooks": {      "active_endpoints": 0,      "unreachable_endpoints": 0    },    "availability": {      "tracked_products": 0,      "mode": "enabled"    }  }}

Put this endpoint to work

Integrate checkout