Whisk Docs
Whisk HomeHelp CenterDeveloper Tools
v1.0.0
v1.0.0
  • Overview
  • Guides
    • Creating An Account
    • Getting Started
    • Whisk Sandbox
  • API
    • Authentication
      • Server Token
      • Client Token
      • User Access Token
      • Anonymous Access
    • Recipes
      • Get Recipe
      • Get Recipe Categories
      • Recipe Objects
    • Recipe Discovery
      • Recipe Feed
      • Recipe Search
      • Get Similar Recipes
    • Shopping Lists
      • Get Shopping Lists
      • Create A Shopping List
      • Add Items To A Shopping List
      • List Analysis
    • Meal Plans
      • Meal Plan Management
      • Delete Meals
      • Auto-Generator
      • Error Handling
    • Retailers
      • Get Available Stores
      • Retailers Checkout Flow
      • Retailer Aliases
      • OAuth Retailer Flow
      • Retailer User Info
      • Search Store Items
    • Carts
      • Create a Cart
      • Update Cart Item
      • Splitting Combined Items
      • Add Items To Cart
      • Add Recipes To Cart
      • Get Cart Item Options
      • Swap Cart Item Product
      • Delete A Cart Or A Cart Item
      • Checkout
    • Users
      • Get A User
      • Update A User
    • User Recipes & Collections
      • Add User Recipe
      • Create A Recipe
      • Update External Recipe
      • Get All User Recipes
      • Update User Recipe
      • Remove Recipe from Favorites
      • Create Collection
      • Get All User Collections
      • Get Collection
      • Get Recipes from a Collection
      • Remove Collection
    • Tools
      • Autocomplete
  • Shopping List SDK
    • Overview
    • Examples
      • Shoppable Recipes
      • Shoppable Products
      • Shoppable Media
    • Basic Setup
      • Basic Setup
      • Methods
      • Event Listeners
      • Widget
      • Subscriptions
      • Global Configuration
      • UTM Parameters
      • Using With SPA
  • Shopping List Mobile API
    • Overview
    • Examples
    • Reference
  • Tips and Tricks
    • Object IDs
    • URL Lookup
    • Searching
    • Multiple IDs request
  • Resources
    • Nutrients
    • Recipe Labels
    • Health Score, Glycemic Index, Glycemic Load
    • Whisk User Data
    • Supported Retailers
    • Optimizing Image Load
Powered by GitBook
On this page
  • Get User
  • Sample Request
  • Response
  • UserPreferences

Was this helpful?

  1. API
  2. Users

Get A User

Endpoint allows getting a User by its IDon the Graph or by externalUserId. This API available only for user access-token integration.

Get User

GET https://graph.whisk.com/v1/me

Path Parameters

Name
Type
Description

id

string

User Id on the Graph or User external Id

{
  "id": "3d4fda8595114a3a9f7b12fd471a4169",
  "externalId": "1654732567",
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe",
  "displayName": "John Doe",
  "pictureUrl": "http://john.doe.picture.url.jpg",
  "updatedAt": 1524150524000,
  "createAt": 1524150524000,
  "preferences": {
    "diets": [
      "vegetarian",
      "vegan"
    ],
    "avoidances": [
      "egg",
      "celery"
    ],
    "dislikedIngredients": [
      {
        "name": "milk"
      }
    ],
    "householdSizeAdults": 2,
    "householdSizeChildren": 1,
    "gender": "male",
    "cookingSkill": "amateur",
    "language": "ko",
    "country": "kr"
  }
}

Sample Request

curl "https://graph.whisk.com/v1/10002493" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer <Access-Token>"

or

curl "https://graph.whisk.com/v1/users/?externalUserId=433201117" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer <Access-Token>"

Response

ATTRIBUTE

TYPE

DESCRIPTION

id

string

The id of the User on Whisk Graph

externalUserId

string

The user id you have defined for the user. (Max limit of 255 UTF-8 characters, and should not have trailing or leading spaces)

email

string

The email you have defined for the user. (Max limit of 255 UTF-8 characters, and should not have trailing or leading spaces)

firstName

string

The first name of the user

lastName

string

The last name of the user

displayName

string

The display name of the user

createdAt

timestamp

The time the user was added to Whisk

updatedAt

timestamp

The last time the user was updated

pictureUrl

string

The profile picture URL of a user

preferences

UserPreferences

UserPreferences

ATTRIBUTE

TYPE

DESCRIPTION

country

string

Country iso code. Examples: gb, kr, us...

zipcode

string

Postal code. Examples: 10001, 80333...

language

string

Language iso code. Examples: en, ko, fr...

cookingSkill

enum

The measure of a person’s competence in preparing and cooking foods Possible values: amateur, intermediate, advanced.

gender

enum

Possible values: female, male.

householdSizeChildren

integer

Number of children

householdSizeAdults

integer

Number of adults Default value: 1

dislikedIngredients

array [string]

Products and ingredients which will be excluded in search and feed APIs.

diets

array [string]

more about diets

avoidances

array [string]

more about avoidances

PreviousUsersNextUpdate A User

Last updated 5 years ago

Was this helpful?