Logo
Getting started
    • Overview
    • Migrate to V3
    • Testing
    • Error handling
    • Client Libraries
    • Webhooks
    • Loyalty Tokens
OAuth API
Admin
  • Authorization
  • Shops
  • Custom Attributes
  • Custom Attribute Groups
  • Brand Kit
  • Subscription Types
CRM
  • Contacts
  • Contact Identifiers
  • Contact Session Tokens
  • Contact Subscriptions
  • Contact Verification
  • Referrals
  • Tiers
Orders API
NEW
  • Orders
  • Order Returns
  • Products
  • Categories
Shifts API
  • Shifts
  • Teams
  • Shift Types
Bookings & Visits API
  • Bookings
  • Visits
Loyalty & Rewards
  • Settings
  • Loyalty Transactions
  • Credit Receptions
  • Rewards
  • Reward Receptions
  • Collectable Rewards
  • Perks
  • Units
Promotion & Vouchers
  • Promotions
  • Vouchers
Giftcard & Prepaid
  • Giftcard
  • Giftcard Transactions
  • Giftcard Programs
  • Prepaid Transactions
Portal Sessions API
  • Portal Sessions
Webhooks
  • Webhooks
Miscellaneous
  • Forms
  • Automations
  • Contacts Portal
Register API

Shops

Note: We are in the process of renaming Shops to Business Profiles

Shops play a central role in most transactions within our system. They can represent physical storefronts or digital web shops. The API calls below enable you to retrieve Shop data by listing Shops or retrieving a single Shop.

Most transactions and activities take place at a certain Shop, and so it's often a required parameter in POST endpoints.

List Shops

Retrieve all Shops belonging to an Account. In case this call is used for a Loyalty flow, then please check for a Loyalty program. None of the Loyalty API calls where a Shop ID is required will work if the Shop used is not linked to a Loyalty Program.

GET
https://api.piggy.eu/api//shops
Headers
Authorization
Bearer {{ access_token | api_key }}
Accept
application/json
Response Example
Show more
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "data": [ { "uuid": "123123", "name": "Amsterdam Pop-up Store", "type": "physical", "reference": null }, { "uuid": "12312312312312", "name": "Web Shop", "type": "web", "reference": "" }, { "uuid": "2222e1242t3324535", "name": "Sesame Street", "type": "physical", "reference": "" }, ], "meta": {} }

Get Shop

Retrieve information of your Shop. This call is useful for getting insights into individual shop settings and attributes.

GET
https://api.piggy.eu/api//shops/{{shop_uuid}}
Headers
Authorization
Bearer {{ access_token | api_key }}
Accept
application/json
Params
shop_uuidstring
REQUIRED
The UUID of the Shop you want to retrieve.
Response Example
Show more
1 2 3 4 5 6 7 8 9 { "data": { "uuid": "123123", "name": "Amsterdam Pop-up Store", "type": "physical", "reference": null }, "meta": {} }