Get User Details by BigCommerce Customer ID

GET

https://api-b2b.bigcommerce.com/api/v3/io/users/customer/:customerId

GET

/api/v3/io/users/customer/:customerId

$ curl https://api-b2b.bigcommerce.com/api/v3/io/users/customer/12345 \
>      -H "X-Auth-Token: <apiKey>"

1 {
2   "code": 200,
3   "data": {
4     "id": 1,
5     "firstName": "Marie",
6     "lastName": "Curie",
7     "email": "john.doe@example.com",
8     "phoneNumber": "+1-555-123-4567",
9     "role": 1,
10     "companyRoleId": 10,
11     "uuid": "user-uuid-1",
12     "extraFields": [
13       {
14         "fieldName": "customField1",
15         "fieldValue": "value1"
16       }
17     ],
18     "companyId": 42,
19     "createdAt": 1,
20     "updatedAt": 1,
21     "customerId": 12345,
22     "companyRoleName": "Approver",
23     "channelList": [
24       {
25         "channelId": 1,
26         "channelName": "Default Storefront",
27         "iconUrl": "https://s3.amazonaws.com/bc-channel-platform/channel-icons/bigcommerce.svg"
28       }
29     ]
30   },
31   "meta": {
32     "message": "Success"
33   }
34 }

Returns detailed information for the user associated with customerId. Analogous to Get User Details. If the B2B Edition customer account associated with customerId has been deleted, this will return a 404 error.

Authentication

X-Auth-Tokenstring

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

For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.

For more about BigCommerce OAuth scopes, see our Guide to API Accounts.

For a list of API status codes, see API Status Codes.

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

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

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

Path parameters

customerIdintegerRequired

The unique numeric ID associated with the BigCommerce customer account. This does not match the userId assigned by B2B Edition.

Response

Success

codeintegerDefaults to 200

Operation status code.

dataobject

metaobject

Errors

404

Not Found Error