Skip to content

Installation

The REST API is in closed beta and runs on paid plans. Contact us to enable it for your store.

In your Appy Stamp admin, open Settings → Developers and find the API Access (REST & GraphQL) section. You will use:

  • API Key, sent as the X-Api-Key header.
  • API Secret, sent as the X-Api-Secret header.

See Authentication for detail on the credentials and rotating the secret.

Terminal window
curl https://stamp.appydesign.io/rest_api/v1/shop \
-H "X-Api-Key: YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET"

A successful response is wrapped in the standard envelope:

{
"success": true,
"data": {
"programName": "Loyalty Rewards",
"currencySymbol": "$"
},
"timestamp": "2026-06-05T12:00:00+00:00"
}

Next, browse the Endpoints, or read the Overview for conventions like the response envelope, pagination, and rate limiting.