Punchh website screenshot

Punchh

Punchh, now part of PAR Technology and offered under the PAR Engagement brand, is an enterprise loyalty, offers, and customer engagement platform for restaurants. It unifies guest data from online ordering, mobile apps, POS, and kiosks into a single view so brands can run personalized loyalty and marketing programs. PAR exposes well-documented Punchh APIs through its developer portal covering platform functions, mobile, online ordering, POS and kiosk integration, and a webhooks manager, with sample collections published to Postman. Most integration surfaces require partner certification. Over 275 restaurant brands rely on Punchh to grow customer lifetime value.

4 APIs 6 Features
RestaurantLoyaltyMarketingGuest EngagementOnline OrderingMobilePoint Of SaleWebhooks

APIs

PAR Punchh Mobile API

Guest-facing loyalty functions for business-branded mobile apps and websites: registration and sign-in, profile management, check-in transaction details, and offer management. C...

PAR Punchh Online Ordering and SSO API

SSO authentication, loyalty check-ins, and redemptions for online ordering platforms. Lets guests earn and redeem rewards against online order receipts. Requires partner certifi...

PAR Punchh POS and Kiosk API

Point-of-sale and kiosk integration: guest lookup and balance, user and check-in creation, location/program configuration, and redemption processing. Authenticated with a locati...

PAR Punchh Platform Functions API

Core programmatic and headless access to the loyalty platform. The Headless Offers API lists offers (redeemables) defined on Punchh for browsing and selection in external platfo...

Collections

Pricing Plans

Punchh Plans Pricing

1 plans

PLANS

Rate Limits

Punchh Rate Limits

4 limits

RATE LIMITS

FinOps

Punchh Finops

FINOPS

Features

Loyalty Programs

Configurable points, rewards, tiers, and membership levels across channels.

Offers and Campaigns

Targeted offers, coupons, and personalized marketing campaigns driven by unified guest data.

Omnichannel Check-Ins

Earn loyalty across mobile, online ordering, POS, and kiosk channels.

Redemptions

Apply rewards, redeemables, and discounts against receipts with possible/create/void flows.

Webhooks Manager

Real-time event notifications for coupons, points, rewards, and guest lifecycle events.

Headless Offers

Surface Punchh-defined offers natively in external platforms via Platform Functions.

Use Cases

Branded Mobile Loyalty App

Power a restaurant brand's mobile app with sign-in, profile, check-ins, and offers.

Online Ordering Rewards

Let guests earn and redeem loyalty on a digital ordering platform via SSO and check-in APIs.

POS Loyalty at the Counter

Look up guests, accrue points, and redeem rewards at the point of sale or kiosk.

External Offer Distribution

Pull Punchh redeemables into a CDP, messaging platform, or partner channel.

Integrations

Point of Sale Systems

Integrations with restaurant POS platforms for in-store loyalty.

Online Ordering Platforms

Digital and online ordering platforms connect via the Online Ordering and SSO API.

Customer Data Platforms

Unify guest data with CDPs and CRMs.

Salesforce Marketing Cloud

Punchh Loyalty connector for Salesforce Marketing Cloud on AppExchange.

Messaging and Payment Gateways

Connects to messaging platforms, surveys, and payment gateways across dozens of categories.

Solutions

Loyalty

Enterprise loyalty program management for restaurant brands.

Offers

Personalized offers and promotions engine.

Guest Engagement

Unified marketing and engagement across the guest lifecycle.

Semantic Vocabularies

Punchh Mobile Context

8 classes · 52 properties

JSON-LD

Punchh Online Ordering Context

4 classes · 27 properties

JSON-LD

Punchh Platform Functions Context

1 classes · 5 properties

JSON-LD

Punchh Pos Context

2 classes · 10 properties

JSON-LD

API Governance Rules

Punchh API Rules

31 rules · 3 errors 17 warnings 11 info

SPECTRAL

JSON Structure

Mobile Access Token Structure

4 properties

JSON STRUCTURE

Mobile Create User Request Structure

4 properties

JSON STRUCTURE

Mobile Login Request Structure

2 properties

JSON STRUCTURE

Mobile Mark Offers Read Request Structure

4 properties

JSON STRUCTURE

Mobile Transaction Details Request Structure

2 properties

JSON STRUCTURE

Mobile Transaction Details Structure

2 properties

JSON STRUCTURE

Mobile Update User Profile Request Structure

2 properties

JSON STRUCTURE

Mobile User Session Structure

2 properties

JSON STRUCTURE

Platform Functions Redeemable Structure

5 properties

JSON STRUCTURE

Pos Pos Checkin Request Structure

4 properties

JSON STRUCTURE

Pos Pos User Structure

6 properties

JSON STRUCTURE

Example Payloads

Mobile Access Token Example

4 fields

EXAMPLE

Mobile Login Request Example

2 fields

EXAMPLE

Mobile User Session Example

2 fields

EXAMPLE

Pos Pos User Example

6 fields

EXAMPLE

Resources

🔗
Website
Website
🔗
Documentation
Documentation
🌐
Portal
Portal
🚀
GettingStarted
GettingStarted
🔗
Postman
Postman
👥
GitHubOrganization
GitHubOrganization
📰
Blog
Blog
🔗
LinkedIn
LinkedIn
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
🔗
Webhooks
Webhooks

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: PAR Punchh POS and Kiosk API
  version: '1.0'
items:
- info:
    name: Users
    type: folder
  items:
  - info:
      name: User Look-Up and Fetch Balance
      type: http
    http:
      method: GET
      url: https://{server_name}.punchh.com/api/pos/users/search
      params:
      - name: phone_number
        value: ''
        type: query
        description: Guest phone number.
      - name: email
        value: ''
        type: query
        description: Guest email address.
      - name: user_as_qrcode
        value: ''
        type: query
        description: Guest QR code value.
      - name: single_scan_code
        value: ''
        type: query
        description: Single scan code value.
      - name: redemption_code
        value: ''
        type: query
        description: Redemption code value.
      - name: card_number
        value: ''
        type: query
        description: Loyalty/gift card number.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Looks up a guest and returns account details and loyalty balances. Provide exactly one identifier (phone number,
      email, QR code, single scan code, redemption code, card number, or Apple NFC token).
  - info:
      name: Create New User
      type: http
    http:
      method: POST
      url: https://{server_name}.punchh.com/api/pos/users
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new guest account from the point of sale.
- info:
    name: Check-Ins
    type: folder
  items:
  - info:
      name: Create Check-In
      type: http
    http:
      method: POST
      url: https://{server_name}.punchh.com/api/pos/checkins
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a loyalty check-in at the point of sale.
- info:
    name: Configuration
    type: folder
  items:
  - info:
      name: Location Configuration
      type: http
    http:
      method: GET
      url: https://{server_name}.punchh.com/api/pos/locations/configuration
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Returns the loyalty configuration for the authenticated location.
  - info:
      name: Program Meta
      type: http
    http:
      method: GET
      url: https://{server_name}.punchh.com/api/pos/meta
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Returns loyalty program metadata for the business.
- info:
    name: Redemptions
    type: folder
  items:
  - info:
      name: Possible Redemptions
      type: http
    http:
      method: POST
      url: https://{server_name}.punchh.com/api/pos/redemptions/possible
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Returns the redemptions available to a guest for the supplied receipt.
  - info:
      name: Create Redemption
      type: http
    http:
      method: POST
      url: https://{server_name}.punchh.com/api/pos/redemptions
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Applies a redemption against a POS receipt.
  - info:
      name: Void Redemption
      type: http
    http:
      method: DELETE
      url: https://{server_name}.punchh.com/api/pos/redemptions
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Voids a previously created redemption.
- info:
    name: Receipts
    type: folder
  items:
  - info:
      name: Store Receipt Details
      type: http
    http:
      method: POST
      url: https://{server_name}.punchh.com/receipt_details
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Stores itemized receipt details for a transaction.
bundled: true