---
title: "OAuth 2.0 - Get user list"
method: POST
path: "   https://wbsapi.withings.net/v2/oauth2"
tags: ["oauth2"]
---

# OAuth 2.0 - Get user list

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

## Request

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

This service allows you to get a list of all users that have authorized your application to fetch their data.

**This service is limited to partners who are integrating with Withings Pro solutions. This service will only work for partners having signed a contract with Withings.**

## Query parameters

- `action` string, required
- `client_id` string, required
- `nonce` string, required
- `signature` string, required
- `offset` integer

## 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.
    - `hash_userid` string
    - `userid` integer: The id of the user.
    - `email` string: User's email address
    - `fully_owned` boolean: Whether or not this user has been created by your oauth2 application. Having created the account gives your application additional rights on this account, such as automatically granted authorizations and access to the retrieve tokens webservice.
    - `more` boolean: To know if there is more data to fetch or not.
    - `offset` integer: Offset to use to retrieve the next data.

---

[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)