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 by Koupon Media. Possible Values: true, false. The value is set to true if the user's age is verified by Koupon Media; otherwise, it is set to false. The response returns this parameter in sign-in, sign-up, and user update APIs if Koupon Media is selected as the age verification adapter for the business in the Punchh platform. Contact your Punchh representative to update this Punchh platform configuration setting.
anniversary
Type: stringFormat: 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: stringFormat: 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
}