Skip to main content

Get sub-organization

GET 
/bv/org/v1/sub-orgs/:id

Fetches a specific sub-organization under the organization using the provided access token.

Required field(s):

  • id
  • Returns a 404/NotFound error if any requested resource is not found.

Request​

Path Parameters

    id stringrequired

    Required. The unique id of the organization.

Responses​

A successful response.

Schema
    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 - ROLE_TYPE_CXM_ADMIN: CXM (string)

    Possible values: [ROLE_TYPE_OWNER, ROLE_TYPE_ADMIN, ROLE_TYPE_STAFF, ROLE_TYPE_DEVELOPER, ROLE_TYPE_CONTENT_CONTRIBUTOR, ROLE_TYPE_CUSTOM, ROLE_TYPE_CXM_ADMIN, ROLE_TYPE_CXM_MODERATOR, ROLE_TYPE_CXM_CONTRIBUTOR, ROLE_TYPE_CXM_PARTICIPANT]

    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.

    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.

    owner_info object
    id string

    Output only. The unique id of the owner account.

    email string

    Output only. The email of the owner.

    invite_status string

    Output only. The invitation status of the owner.

Loading...