User (Object)

Includes details about the users who are registered on a particular business

address
Type: string

Address of the user
age_verified_status
Type: boolean

Whether or not the user has undergone age verification. Possible Values: true, false. The value is set to true if the user's age is verified; otherwise, it is set to false. The response returns this parameter in sign-in, sign-up, and user update APIs if the age verification is enabled for the business in the Punchh platform. Contact your Punchh representative to update this Punchh platform configuration setting.
anniversary
Type: string Format: date

Anniversary date of the user, in YYYY-MM-DD format
apple_signup
Type: boolean

Whether the user has an Apple sign-up or not. This will return true for the first time sign-up.
apple_uid
Type: string

Unique ID generated by Apple
avatar_remote_url
Type: string

URL of the user's profile image uploaded to an online file storage system. This will be used for users who signed up using email.
birthday
Type: string Format: date

Date of birth of the user, in YYYY-MM-DD format
city
Type: string

City where the user lives
communicable_email
Type: string

Email address used for communication with the user
created_at
Format: date-timeenum
const:
YYYY-MM-DDThh:mm:ssZ

Date/time when the user was created in the system, in ISO 8601 format
values
- YYYY-MM-DDThh:mm:ssZ
email
Type: string

Unique email address used to identify the user
email_verified
Type: boolean

Whether the email address of the user has been verified or not
facebook_signup
Type: boolean

Whether the user has a Facebook sign-up or not
favourite_location_ids
Type: string

List of the user's favorite locations
favourite_store_numbers
Type: string

List of store numbers of the user's favorite locations
fb_uid
Type: string

Facebook ID that identifies the user
first_name
Type: string

First name of the user
gender
Type: string

Gender of the user
has_generated_fb_email
Type: boolean

Whether the user has generated a Facebook email or not
last_name
Type: string

Last name of the user
marketing_email_subscription
Type: boolean

Whether the user has subscribed to receive marketing emails or not
marketing_pn_subscription
Type: boolean

Whether the user has subscribed to marketing push notifications or not
migrate_status
Type: boolean

Whether the user has a migrate status or not
passcode_configured_for_giftcards
Type: boolean

Whether the user has configured a passcode for gift cards or not
phone
Type: string

Phone number of the user
preferred_locale
Type: string

Preferred locale of the user
privacy_policy
Type: boolean

Whether the user has agreed to the privacy policy to use the app as per the configuration or not
profile_field_answers
Type: object

Answers given by the user while filling in the user profile. The user submits answers to profile field questions that are configured in the Punchh platform. A total of 25 answers can be submitted. The keys range from 'upf0' to 'upf24'. If questions have multiple answers, the values should be separated by a | character (pipe).
- upf0
  Type: string
  
  Each profile field (upf0 - upf24) corresponds to a line from the configuration in the Punchh platform.
- upf1
  Type: string
  
  Each profile field (upf0 - upf24) corresponds to a line from the configuration in the Punchh platform.
- upf2
  Type: string
  
  Each profile field (upf0 - upf24) corresponds to a line from the configuration in the Punchh platform.
referral_code
Type: string

Referral code of the user
secondary_email
Type: string

The secondary email address of the user is configured when a user signs up with Facebook/Apple but does not share the email address. The app asks for an alternate email address, which is kept as the secondary_email.
sms_subscription
Type: boolean

Whether the user has subscribed to SMS services or not
state
Type: string

State where the user lives
superuser
Type: boolean

Whether multiple check-ins are allowed for a user. This is used mostly for testing purposes by developers.
terms_and_conditions
Type: boolean

Whether the terms and conditions of a business have been accepted by a user or not
title
Type: string

Salutation as selected by the user
updated_at
Format: date-timeenum
const:
YYYY-MM-DDThh:mm:ssZ

Date/time when the user was updated in the system, in ISO 8601 format
values
- YYYY-MM-DDThh:mm:ssZ
user_as_qrcode
Type: string

QR code that identifies the user
user_code
Type: string

A unique ID that identifies the user. This smaller code can be converted to a QR code in the app and scanned at some POS systems that do not support longer codes. Alternatively, a user could give this to the POS operator if the POS does not have a scanner.
user_id
Type: integer

ID that identifies the user
user_relations
Type: array

Relatives of the user. Valid values are "kid" and "spouse".
verification_mode
Type: string

Mode of verification (available only for a user in awaiting migration state)
zip_code
Type: string

Zip code where the user lives

Examples

{
  "address": "",
  "anniversary": null,
  "avatar_remote_url": null,
  "birthday": null,
  "city": "",
  "communicable_email": "test@example.com",
  "created_at": "2019-04-24T12:39:06Z",
  "email": "test@example.com",
  "email_verified": false,
  "facebook_signup": null,
  "apple_signup": null,
  "apple_uid": null,
  "favourite_location_ids": "",
  "favourite_store_numbers": "",
  "fb_uid": null,
  "first_name": "FIRST_NAME_GOES_HERE",
  "gender": "",
  "has_generated_fb_email": false,
  "last_name": "LAST_NAME_GOES_HERE",
  "marketing_email_subscription": true,
  "marketing_pn_subscription": true,
  "migrate_status": false,
  "passcode_configured_for_giftcards": false,
  "phone": "1111111111",
  "profile_field_answers": {},
  "referral_code": "REFERRAL_CODE_GOES_HERE",
  "referral_path": "URL_GOES_HERE",
  "secondary_email": "",
  "state": "",
  "superuser": false,
  "terms_and_conditions": true,
  "title": "",
  "updated_at": "2020-05-06T14:52:24Z",
  "user_as_qrcode": "QR_CODE_GOES_HERE",
  "user_code": "P11111111",
  "user_id": 111111111,
  "preferred_locale": "",
  "user_relations": [],
  "zip_code": null,
  "verification_mode": null,
  "sms_subscription": false,
  "privacy_policy": false
}