List Users | BigCommerce Developer Center

Returns a list of a Company’s users by role.

Equivalent Storefront GraphQL API Query: users. For more information, see the GraphQL Playground.

The role parameter allows you to filter for users that have a predefined Company role. You can also view all users in a Company, or users with an unknown role.

Returns a list of a Company’s users by role. Equivalent Storefront GraphQL API Query: `users`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground). The `role` parameter allows you to filter for users that have a predefined Company role. You can also view all users in a Company, or users with an unknown role.

Authentication

AuthorizationBearer

Authentication header

Header	Argument	Description
`Authorization`	`Bearer {{B2B_JWT_TOKEN}}`	You can obtain this token using the steps described in the REST Storefront API section[…]

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| |`Authorization`|`Bearer {{B2B_JWT_TOKEN}}`| You can obtain this token using the steps described in the [REST Storefront API](/developer/docs/b2b-edition/getting-started/authentication#rest-storefront-api) section[...]

Query parameters

qstringOptional

The search string for the request.

roleenumRequired

The ID of the role assigned to the Company user account as given below.

Value	Code
0	Admin
1	Senior Buyer
2	Junior Buyer
3	Super Admin
4	Unknown

The ID of the role assigned to the Company user account as given below. | Value | Code | | --- | --- | | 0 | Admin | | 1 | Senior Buyer | | 2 | Junior Buyer | | 3 | Super Admin | | 4 | Unknown |

Allowed values:

limitstringOptionalDefaults to 10

The total number of items per page of the response.

offsetstringOptional

The number of items to skip before the current page of the response.

Response

codedoubleDefaults to 200

dataobject

messagestringDefaults to SUCCESS

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v2/users"
4
5	querystring = {"role":"0","limit":"10","offset":"0"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"code": 200,
3	"data": {
4	"list": [
5	{
6	"createdAt": "1618794615",
7	"email": "m.curie@greatbuys.com",
8	"firstName": "Marie",
9	"id": "123",
10	"lastName": "Curie",
11	"phoneNumber": "8001234567",
12	"role": "1",
13	"updatedAt": "1618794615"
14	}
15	],
16	"pagination": {
17	"totalCount": 175,
18	"offset": 0,
19	"limit": 10
20	}
21	},
22	"message": "string"
23	}