---
title: "User v2 - Get"
method: POST
path: "https://wbsapi.withings.net/v2/user"
tags: ["user"]
---

# User v2 - Get

`POST https://wbsapi.withings.net/v2/user`

## Request

- Base URL: `https://wbsapi.withings.net`
- URL: `https://wbsapi.withings.net/https://wbsapi.withings.net/v2/user`
- Auth: none declared

Returns user information.

**For data privacy reasons, this webservice is only available for integration solutions for which the provider is responsible for the account creation (ie Withings Cellular Solutions and Withings Mobile SDK integrations).**
**This webservice will return an error the above condition is not met.**

## Query parameters

- `action` string, required
- `client_id` string, required
- `nonce` string, required
- `signature` string, required
- `email` unknown
- `userid` unknown

## Response `200`

(Click to unfold)

- object
  - `status` integer: Response status. See <a href='#tag/response_status'>Status</a> section for details.
  - `body` object: Response data.
    - `user` object
      - `email` string: User's email address
      - `firstname` string: User's firstname
      - `lastname` string: User's lastname
      - `shortname` string: User's shortname
      - `gender` integer: User's gender (0: man, 1: woman)
      - `birthdate` integer: Unix timestamp of user's birthdate
      - `preflang` string: User's language preference. Examples: en_EN / en_US / de_DE / es_ES / fr_FR / it_IT / ja_JA / ko_KR / nl_NL / pt_PT / ru_RU / zh_CN
      - `timezone` string: User's timezone. Examples: "Europe/Paris" / "America/New_York". A complete list of all possible timezones can be found on the "TZ database name" column of this page : https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      - `mailingpref` boolean: User consent to receiving sales and marketing communication from Withings (0: user does not consent, 1: user does consent)
      - `unit_pref` object: User's unit preferences (cf. [Unit preferences](#tag/models/Unit-preferences) model).
        - `weight` integer
        - `height` integer
        - `temperature` integer
        - `distance` integer
      - `phonenumber` string: User's phone number. *(Only if set)*

---

[API](https://skmtc.dev/withings/apis/withings-developer-documentation.md) - [All operations](https://skmtc.dev/withings/apis/withings-developer-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/withings/apis/withings-developer-documentation/revisions/9e9accd01d4b?raw)