List B2B Users | BigCommerce Developer Center

Returns a paginated list of B2B users with optional filters.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

X-Store-Hashstring

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Query parameters

offsetintegerOptional>=0Defaults to 0

The number of items to skip before starting to collect the result set.

limitintegerOptional1-250Defaults to 10

The maximum number of results to return.

companyIdintegerOptional

If included, filters users in the response based on their Company ID as reported by the Server to Server Companies endpoints.

roleslist of enumsOptional

Filters users according to their assigned role ID. This filter is limited to admin (0), senior buyer (1), and junior buyer (2).

By default, custom roles are treated as junior buyer, but they can be differentiated in the response data by the companyRoleId and companyRoleName fields. For more information, see Company Roles and Permissions.

Filters users according to their assigned role ID. This filter is limited to admin (`0`), senior buyer (`1`), and junior buyer (`2`). By default, custom roles are treated as junior buyer, but they can be differentiated in the response data by the `companyRoleId` and `companyRoleName` fields. For more information, see [Company Roles and Permissions](/developer/api-reference/rest/b2b/management/company-roles-and-permissions).

Allowed values:

minModifiedstringOptional

Filters results by the updatedAt field, returning only those with a Unix timestamp later than minModified.

Filters results by the `updatedAt` field, returning only those with a [Unix timestamp](https://www.unixtimestamp.com/) later than `minModified`.

maxModifiedstringOptional

Filters results by the updatedAt field, returning only those with a Unix timestamp earlier than maxModified.

Filters results by the `updatedAt` field, returning only those with a [Unix timestamp](https://www.unixtimestamp.com/) earlier than `maxModified`.

minCreatedstringOptional

Filters results by the createdAt field, returning only those with a Unix timestamp later than minCreated.

Filters results by the `createdAt` field, returning only those with a [Unix timestamp](https://www.unixtimestamp.com/) later than `minCreated`.

maxCreatedstringOptional

Filters results by the createdAt field, returning only those with a Unix timestamp earlier than maxCreated.

Filters results by the `createdAt` field, returning only those with a [Unix timestamp](https://www.unixtimestamp.com/) earlier than `maxCreated`.

emailstringOptionalformat: "email"

Filters users by email address. This field requires an exact match.

channelIdintegerOptional

Filters users by their assigned BigCommerce channel ID.

isIncludeExtraFieldsenumOptional

Indicates whether to include extra fields in the response. A value of 1 indicates they will be included, while a value of 0 indicates they will not.

Allowed values:

qstringOptional

Broader search term for filtering on supported fields. Currently this includes Company, email, and name fields.

Response

SUCCESS

codeintegerDefaults to 200

Operation status code.

datalist of objects

metaobject

Errors

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v3/io/users"
4
5	querystring = {"companyId":"42","roles":"[0,1]","minModified":"1700000000","maxModified":"1705000000","minCreated":"1690000000","maxCreated":"1700000000","email":"jane.smith@company.com","channelId":"1","isIncludeExtraFields":"1","q":"Smith"}
6
7	payload = {
8	"offset": 0,
9	"limit": 10
10	}
11	headers = {
12	"X-Auth-Token": "<apiKey>",
13	"Content-Type": "application/json"
14	}
15
16	response = requests.get(url, json=payload, headers=headers, params=querystring)
17
18	print(response.json())

1	{
2	"code": 200,
3	"data": [
4	{
5	"channelList": [
6	{
7	"channelId": 1,
8	"channelName": "Default Storefront",
9	"iconUrl": "https://s3.amazonaws.com/bc-channel-platform/channel-icons/bigcommerce.svg"
10	}
11	],
12	"companyId": 42,
13	"companyRoleId": 10,
14	"companyRoleName": "Approver",
15	"createdAt": 1695000000,
16	"customerId": 12345,
17	"email": "jane.smith@company.com",
18	"extraFields": [
19	{
20	"fieldName": "department",
21	"fieldValue": "Sales"
22	},
23	{
24	"fieldName": "location",
25	"fieldValue": "New York"
26	}
27	],
28	"firstName": "Jane",
29	"id": 101,
30	"lastName": "Smith",
31	"phoneNumber": "+1-555-987-6543",
32	"role": 1,
33	"updatedAt": 1701000000,
34	"uuid": "user-uuid-101"
35	},
36	{
37	"channelList": [
38	{
39	"channelId": 1,
40	"channelName": "Default Storefront",
41	"iconUrl": "https://s3.amazonaws.com/bc-channel-platform/channel-icons/bigcommerce.svg"
42	}
43	],
44	"companyId": 42,
45	"companyRoleId": 5,
46	"companyRoleName": "Administrator",
47	"createdAt": 1694000000,
48	"customerId": 12346,
49	"email": "michael.johnson@company.com",
50	"extraFields": [
51	{
52	"fieldName": "department",
53	"fieldValue": "Management"
54	}
55	],
56	"firstName": "Michael",
57	"id": 102,
58	"lastName": "Johnson",
59	"phoneNumber": "+1-555-123-7890",
60	"role": 0,
61	"updatedAt": 1702000000,
62	"uuid": "user-uuid-102"
63	}
64	],
65	"meta": {
66	"message": "Success",
67	"pagination": {
68	"totalCount": 100,
69	"limit": 10,
70	"offset": 0
71	}
72	}
73	}