List Company Users | BigCommerce Developer Center

Returns a list of users associated with a Company account.

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

Returns a list of users associated with a Company account. Equivalent Storefront GraphQL API Query: `users`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground).

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[...]

Path parameters

companyIdstringRequired

Query parameters

role[]enumOptional

The ID of the role assigned to the Company user account as defined at Specifying User Role.

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.

qstringOptional

The search string for the request.

minLastModifiedTimestringOptional

The earliest Unix timestamp for when the Company account was modified that can be returned.

The earliest [Unix timestamp](https://www.unixtimestamp.com/) for when the Company account was modified that can be returned.

maxLastModifiedTimestringOptional

The latest Unix timestamp for when the Company account was modified that can be returned.

The latest [Unix timestamp](https://www.unixtimestamp.com/) for when the Company account was modified that can be returned.

minLastCreatedTimestringOptional

The earliest Unix timestamp for when the Company account was created that can be returned.

The earliest [Unix timestamp](https://www.unixtimestamp.com/) for when the Company account was created that can be returned.

maxLastCreatedTimestringOptional

The earliest Unix timestamp for when the Company account was created that can be returned.

The earliest [Unix timestamp](https://www.unixtimestamp.com/) for when the Company account was created that can be returned.

Response

codedoubleDefaults to 200

dataobject

messagestringDefaults to SUCCESS

1	curl -G https://api-b2b.bigcommerce.com/api/v2/companies/companyId/users \
2	-H "Authorization: Bearer <token>" \
3	-d "role[]=0" \
4	-d limit=10 \
5	-d offset=0 \
6	-d minLastModifiedTime=1618794615 \
7	-d maxLastModifiedTime=1618794615 \
8	-d minLastCreatedTime=1618794615 \
9	-d maxLastCreatedTime=1618794615

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