User (Object)

{
  "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
}

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

    • 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).

  • 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

    • 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 object[]

    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