List accounts

GET 
/bv/account/v1/accounts

Lists the accounts in the current organization using the provided access token.

Request

Query Parameters

current_page int32

Optional. The current page in the current pagination. If enable_pagination is true, need to assign positive number. Min: 1 Max: 100

items_per_page int32

Optional. The number of items per page in the current pagination. If enable_pagination is true, need to assign positive number. Min: 1 Max: 100

enable_pagination boolean

Optional. Enable pagination. Default: false

email string

Optional. The filter of specific email It will return the results which are contain the filter of email.

status string[]

Optional. The filter of specific account status. The example of status: ACCOUNT_STATUS_ACTIVATED,ACCOUNT_STATUS_DEACTIVATED

keyword string

Optional. If provided, the API will filter accounts by E-Mail or full name.

sorts string[]

Possible values: [ACCOUNTS_SORT_TYPE_FIRST_NAME_ASC, ACCOUNTS_SORT_TYPE_FIRST_NAME_DESC, ACCOUNTS_SORT_TYPE_LAST_NAME_ASC, ACCOUNTS_SORT_TYPE_LAST_NAME_DESC]

Optional. The sorting of accounts.

Header Parameters

x-bv-org-id stringrequired

To invoke this API using api_token, you need to set the x-bv-org-id header to specify the organization for which you want to perform the action.

Responses

200

A successful response.

application/json

Schema

Schema

account object[]
Array [
id string
Output only. The resource identifier of account.
email Required. The email of account (string)required
password stringrequired
Required. The password of account. Password policy: Contains at least 1 number. Contains at least 1 special character. Contains at least 1 uppercase letter. Contains at least 1 lowercase letter.
first_name stringrequired
Required. The first name of account.
last_name stringrequired
Required. The last name of account.
status string
Possible values: [ACCOUNT_STATUS_ACTIVATED, ACCOUNT_STATUS_DEACTIVATED]
Output only. The status of account.
default_org_id Output only. The default organization of account. The account login the console, will enter default organization workspace automatically (string)
account_infos object[]
Array [
organization object
id string
Output only. The resource identifier of the organization.
name string
Output only. The name of the organization.
parent_id string
Output only. The appended parent organization id.
type string
Possible values: [ORGANIZATION_TYPE_ROOT, ORGANIZATION_TYPE_GENERAL_DISTRIBUTOR, ORGANIZATION_TYPE_RESELLER, ORGANIZATION_TYPE_BUSINESS]
Output only. Indicates the type of the organization.
status string
Possible values: [ORGANIZATION_STATUS_ACTIVATED, ORGANIZATION_STATUS_VERIFYING, ORGANIZATION_STATUS_FAIL_TO_VERIFY, ORGANIZATION_STATUS_DEACTIVATED, ORGANIZATION_STATUS_DELETING, ORGANIZATION_STATUS_DELETED, ORGANIZATION_STATUS_ACTIVATION_SCHEDULED]
Output only. Indicates the status of the organization.
description string
Output only. The description of the organization.
owner_email string
Output only. The owner email of the organization.
billing_cycle int32
Output only. The billing cycle of the organization.
contract_valid_start_time date-time
Output only. The contract valid start day won't be valid before the day.
contract_months int32
Output only. The contract duration unit. It might one of the contract_months or contract_days.
contract_days int32
Output only. The contract duration unit. It might one of the contract_months or contract_days.
contract_valid_end_time date-time
Output only. The contract valid end day won't be valid after the day.
next_contract object
Output only. The next contract of the organization.
start_time date-time
Output only. The start time of the organization.
months int32
Output only. The months of the organization.
days int32
Output only. The days of the organization.
end_time date-time
Output only. The valid end time of the organization.
parent_id string
Output only. The parent id of the organization.
plan_id string
Output only. The plan id of the organization.
has_sub_orgs boolean
Output only. Indicates there are sub-organizations appended to the organization.
parent_name string
Output only. The name of appended parent organization.
license_key string
Output only.
time_zone string
Output only. The time zone of the organization.
owner object
id string
Output only. The unique id of the user.
email string
Output only. The email of the user.
status string
Possible values: [ACCOUNT_STATUS_ACTIVATED, ACCOUNT_STATUS_DEACTIVATED]
Output only. The status of the user.
role_type string
Possible values: [ROLE_TYPE_OWNER, ROLE_TYPE_ADMIN, ROLE_TYPE_STAFF, ROLE_TYPE_DEVELOPER, ROLE_TYPE_CONTENT_CONTRIBUTOR, ROLE_TYPE_CUSTOM]
Output only. The role of the user.
created_at date-time
Output only. The created time of the user.
first_name string
Output only. The first name of the user.
last_name string
Output only. The last name of the user.
role_id string
Output only. The id of role.
business_setting object
business_plan_type string
Possible values: [BUSINESS_PLAN_TYPE_BVONE, BUSINESS_PLAN_TYPE_CXM, BUSINESS_PLAN_TYPE_CPM]
Output only. The plan type of the business sub-organization. Values:
• BUSINESS_PLAN_TYPE_BVONE: Indicates the BVOne plan, allowing the business sub-organization to create sites and enable custom domains.
• BUSINESS_PLAN_TYPE_CXM: Indicates the CXM plan, allowing add the marketplace url.
category Optional. The category of the business sub-organization. This field is optional and can contain custom classifications. Max length: 40 (string)
tax_id Optional. The tax ID of the business sub-organization. Max length: 8 (string)
enable_create_site boolean
Optional. Indicates whether the business sub-organization has permission to create sites. This field should only be provided when the business sub-organization plan is BVOne plan.
site_limit int32
Optional. The maximum number of sites that the business sub-organization can create. This field should only be provided when the business sub-organization plan is BVOne plan. This field is optional and must be within the range of 0 to 50, inclusive.
enable_custom_domain boolean
Optional. Indicates if the business sub-organization can enable a custom domain. This field should only be provided when the business sub-organization plan is BVOne plan.
marketplace_url string
Optional. The marketplace URL of the business sub-organization. This field should only be provided when the business sub-organization plan is CXM plan. Max length: 2000, must be a valid URL format.
created_at date-time
Output only.
updated_at date-time
Output only.
role_type string
Possible values: [ROLE_TYPE_OWNER, ROLE_TYPE_ADMIN, ROLE_TYPE_STAFF, ROLE_TYPE_DEVELOPER, ROLE_TYPE_CONTENT_CONTRIBUTOR, ROLE_TYPE_CUSTOM]
groups object[]
Array [
id string
Output only. The unique id of the group.
name string
Output only. The name of the group.
description string
Output only. The description of the group.
creator_name string
Output only. The name of the creator for the group.
user_infos object[]
Output only.
Array [
id string
Output only. The unique id of the user.
email string
Output only. The email of the user.
status string
Possible values: [ACCOUNT_STATUS_ACTIVATED, ACCOUNT_STATUS_DEACTIVATED]
Output only. The status of the user.
role_type string
Possible values: [ROLE_TYPE_OWNER, ROLE_TYPE_ADMIN, ROLE_TYPE_STAFF, ROLE_TYPE_DEVELOPER, ROLE_TYPE_CONTENT_CONTRIBUTOR, ROLE_TYPE_CUSTOM]
Output only. The role of the user.
created_at date-time
Output only. The created time of the user.
first_name string
Output only. The first name of the user.
last_name string
Output only. The last name of the user.
role_id string
Output only. The id of role.
]
members int32
Output only. The number of members in the group.
created_at date-time
Output only. The timestamp of the group that was created.
updated_at date-time
Output only. The timestamp of the group that was last updated.
]
]
connected_accounts object[]
Array [
id string
Output only. The id of connected account.
provider string
Possible values: [OAUTH2_PROVIDER_GOOGLE]
Output only. The provider of connected account.
email string
Output only. The email of connected account.
]
attrs object
property name* string
created_at date-time
Output only.
updated_at date-time
Output only.
nickname string
Optional. The nickname of account.
avatar_icon_url string
Output only. The avatar icon url of account.
]
pagination object

total_items int32

Output only. The total numbers of the list in the current pagination.

items_per_page int32

Output only. The number of items per page in the current pagination.

current_page int32

Output only. The current page in the current pagination.

Example (from schema)

{
  "account": [
    {
      "account_infos": [
        {
          "groups": [],
          "organization": {
            "billing_cycle": 0,
            "contract_days": 0,
            "contract_months": 0,
            "contract_valid_end_time": null,
            "contract_valid_start_time": null,
            "created_at": "2023-04-24T03:49:27Z",
            "description": "",
            "has_sub_orgs": false,
            "id": "edc115ec-9d62-402d-b2aa-2f31a6d37ffb",
            "license_key": "",
            "name": "test-org",
            "owner_email": "",
            "parent_id": "",
            "parent_name": "",
            "status": "ORGANIZATION_STATUS_ACTIVATED",
            "time_zone": "",
            "type": "ORGANIZATION_TYPE_BUSINESS",
            "updated_at": "2023-06-05T05:30:35Z"
          },
          "role_type": "ROLE_TYPE_STAFF"
        }
      ],
      "attrs": {},
      "created_at": "2023-06-05T05:31:53Z",
      "default_org_id": "edc115ec-9d62-402d-b2aa-2f31a6d37ffb",
      "email": "test+11231@kkcompany.com",
      "first_name": "test",
      "id": "91fc7f17-9877-436f-8137-647043b83c98",
      "last_name": "test",
      "password": "",
      "status": "ACCOUNT_STATUS_ACTIVATED",
      "updated_at": "2023-06-05T05:31:53Z"
    },
    {
      "account_infos": [
        {
          "groups": [],
          "organization": {
            "billing_cycle": 0,
            "contract_days": 0,
            "contract_months": 0,
            "contract_valid_end_time": null,
            "contract_valid_start_time": null,
            "created_at": "2023-04-24T03:49:27Z",
            "description": "",
            "has_sub_orgs": false,
            "id": "edc115ec-9d62-402d-b2aa-2f31a6d37ffb",
            "license_key": "",
            "name": "test-org",
            "owner_email": "",
            "parent_id": "",
            "parent_name": "",
            "status": "ORGANIZATION_STATUS_ACTIVATED",
            "time_zone": "",
            "type": "ORGANIZATION_TYPE_BUSINESS",
            "updated_at": "2023-06-05T05:30:35Z"
          },
          "role_type": "ROLE_TYPE_STAFF"
        }
      ],
      "attrs": {},
      "created_at": "2023-06-05T05:36:53Z",
      "default_org_id": "edc115ec-9d62-402d-b2aa-2f31a6d37ffb",
      "email": "test+1123199@kkcompany.com",
      "first_name": "test",
      "id": "0ea4963a-6e82-4509-ba96-721642c9a83f",
      "last_name": "test",
      "password": "",
      "status": "ACCOUNT_STATUS_ACTIVATED",
      "updated_at": "2023-06-05T05:36:53Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "items_per_page": 10,
    "total_items": 6
  }
}

400

A bad request response. The code is 3 means got an invalid argument. There are more HTTP status code mappings listed on here and gRPC code on here.

application/json

Schema

Schema

code int32
message string
details object[]
Array [
@type string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:
• If no scheme is provided, https is assumed.
• An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
• Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.
Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

401

A unauthenticated response. The header authorization was missing or unidentified.

application/json

Schema

Schema

code int32
message string
details object[]
Array [
@type string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:
• If no scheme is provided, https is assumed.
• An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
• Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.
Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

403

A forbidden response. It means that the provided authorization did not have enough permission to access the resource or the API.

application/json

Schema

Schema

code int32
message string
details object[]
Array [
@type string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:
• If no scheme is provided, https is assumed.
• An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
• Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.
Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

500

A server error response. There are more HTTP status code mappings listed on here.

application/json

Schema

Schema

code int32
message string
details object[]
Array [
@type string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:
• If no scheme is provided, https is assumed.
• An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
• Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.
Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

default

An unexpected error response.

application/json

Schema

Schema

code int32
message string
details object[]
Array [
@type string
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:
• If no scheme is provided, https is assumed.
• An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
• Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.
Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Loading...