<commit_before>---
title: GET Users Bulk API
layout: reference
---


# PREVIEW - Get Users Bulk API

* [Overview]()
* [Obtain Company Token](#company)
* [Calling /users Bulk API](#usersbulk)


## <a name="company"></a>Obtain Company Token

Company is a top-level principal within Concur and you would be able to obtain an access token and a refresh token on a Company's behalf just like you would be able to with a User. Only one authorization flow is currently available for obtaining tokens for a Company, which is the [Password grant](/api-reference/authentication/apidoc.html#password_grant).

Instructions for obtaining a Company Token is here : https://developer.concur.com/api-reference/authentication/company-auth.html 

## <a name="usersbulk"></a>Calling /users Bulk API

Once you have the Company Token, you would call the `/users/` endpoint to retrieve a list of users that belong to that company.

This endpoint will also return basic company information together with the list of users.<commit_msg>Updated 3.1 docs to inform of proper use<commit_after>---
title: GET Users Bulk API
layout: reference
---


# PREVIEW - Get Users Bulk API

## THIS IS AN EXPERIMENTAL API. PLEASE DO NOT USE WITHOUT PRIOR AUTHORIZATION FROM THE CORE-SERVICES TEAM IN CONCUR. ##

* [Overview]()
* [Obtain Company Token](#company)
* [Calling /users Bulk API](#usersbulk)


## <a name="company"></a>Obtain Company Token

Company is a top-level principal within Concur and you would be able to obtain an access token and a refresh token on a Company's behalf just like you would be able to with a User. Only one authorization flow is currently available for obtaining tokens for a Company, which is the [Password grant](/api-reference/authentication/apidoc.html#password_grant).

Instructions for obtaining a Company Token is here : https://developer.concur.com/api-reference/authentication/company-auth.html 

## <a name="usersbulk"></a>Calling /users Bulk API

Once you have the Company Token, you would call the `/users/` endpoint to retrieve a list of users that belong to that company.

This endpoint will also return basic company information together with the list of users.
{'fraction_non_alphanumeric': 0.08294930875576037, 'fraction_numerical': 0.0009216589861751152, 'mean_word_length': 4.49620253164557, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6536462', 'n_tokens_mistral': 600, 'n_tokens_neox': 574, 'n_words': 282}