Get account information based on token
GEThttps://api.one.blendvision.com/bv/account/v1/accounts/info
Fetches the account information using the provided access token.
Request
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
- 400
- 401
- 403
- 500
- default
A successful response.
- application/json
- Schema
- Example (from schema)
Schema
account object
{
"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": "2022-12-05T07:30:23Z",
"description": "",
"has_sub_orgs": false,
"id": "04212e7d-16ab-4996-bc3a-cf88719cd867",
"license_key": "",
"name": "KKS Root 1234",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_ACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_ROOT",
"updated_at": "2023-05-18T11:37:21Z"
},
"role_type": "ROLE_TYPE_ADMIN"
},
{
"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-20T03:46:49Z",
"description": "",
"has_sub_orgs": false,
"id": "27b426ae-f120-4478-b62a-328ba6a5fe5c",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:01:35Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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-20T03:42:49Z",
"description": "",
"has_sub_orgs": false,
"id": "37cfa5f0-b5a2-45e7-8e07-6f129bf91a49",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:00:21Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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-27T06:39:00Z",
"description": "",
"has_sub_orgs": false,
"id": "38b3cac3-aeeb-4b99-8e8b-b2e1671d526b",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-21T01:00:28Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2023-05-15T03:58:46Z",
"description": "",
"has_sub_orgs": false,
"id": "4850d55e-0187-4bb9-98e3-8f708667e33c",
"license_key": "",
"name": "test-free-trial",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-16T01:00:21Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2023-05-19T03:26:50Z",
"description": "",
"has_sub_orgs": false,
"id": "4ea8f6f1-ec6f-4764-952e-2eee02bdec6d",
"license_key": "",
"name": "test-pricing-plan-jp-email",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_ACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-19T03:27:00Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2023-05-15T06:08:40Z",
"description": "",
"has_sub_orgs": false,
"id": "561f5a5e-6670-4e77-9c15-a49740bc4fad",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-21T01:01:38Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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-20T03:43:37Z",
"description": "",
"has_sub_orgs": false,
"id": "5ded9b55-a501-4f6c-ae74-91a59a4ff0f9",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:00:27Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2023-05-15T06:07:50Z",
"description": "",
"has_sub_orgs": false,
"id": "6687a3fa-4955-4928-aad0-c3527051690a",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-21T01:01:33Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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:35Z",
"description": "",
"has_sub_orgs": false,
"id": "74e4de81-b1c5-4dff-bcc0-5b4f1ac957e1",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-06-05T01:00:30Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2022-12-07T10:06:14Z",
"description": "",
"has_sub_orgs": false,
"id": "7c8ad6ad-7f25-4cc1-a315-569804bd0757",
"license_key": "",
"name": "test-RS",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_ACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_RESELLER",
"updated_at": "2023-05-15T06:01:26Z"
},
"role_type": "ROLE_TYPE_ADMIN"
},
{
"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-20T03:45:08Z",
"description": "",
"has_sub_orgs": false,
"id": "933e3e09-4224-4e36-8559-cfe32a9e8f7a",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:01:29Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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-20T05:05:12Z",
"description": "",
"has_sub_orgs": false,
"id": "cfa186c9-0ec1-4cd1-bcfe-68786c99162f",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:03:59Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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:42:40Z",
"description": "",
"has_sub_orgs": false,
"id": "ddfcc3d3-7f08-4e19-b18f-dc6ef608374b",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-21T01:00:22Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"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"
},
{
"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-20T04:38:13Z",
"description": "",
"has_sub_orgs": false,
"id": "f243463a-b924-42a8-a913-70055c100e7c",
"license_key": "",
"name": "test-org",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DEACTIVATED",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-05-20T01:03:53Z"
},
"role_type": "ROLE_TYPE_OWNER"
},
{
"groups": [],
"organization": {
"billing_cycle": 0,
"contract_days": 0,
"contract_months": 0,
"contract_valid_end_time": null,
"contract_valid_start_time": null,
"created_at": "2022-12-07T10:06:13Z",
"description": "",
"has_sub_orgs": false,
"id": "f92b3ed6-1279-4489-b735-54aff2351418",
"license_key": "",
"name": "test-BS",
"owner_email": "",
"parent_id": "",
"parent_name": "",
"status": "ORGANIZATION_STATUS_DELETING",
"time_zone": "",
"type": "ORGANIZATION_TYPE_BUSINESS",
"updated_at": "2023-03-30T09:29:14Z"
},
"role_type": "ROLE_TYPE_ADMIN"
}
],
"attrs": {},
"created_at": "2023-01-16T07:45:19Z",
"default_org_id": "27b426ae-f120-4478-b62a-328ba6a5fe5c",
"email": "test@kkcompany.com",
"first_name": "test",
"id": "176298c6-c599-4435-9673-e8b63dbd1ab7",
"last_name": "tan",
"password": "",
"status": "ACCOUNT_STATUS_ACTIVATED",
"updated_at": "2023-06-06T01:56:40Z"
}
}
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
- Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A unauthenticated response.
The header authorization
was missing or unidentified.
- application/json
- Schema
- Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A forbidden response.
It means that the provided authorization
did not have enough permission to access the resource or the API.
- application/json
- Schema
- Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
A server error response. There are more HTTP status code mappings listed on here.
- application/json
- Schema
- Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- Schema
- Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Authorization: authorization
name: authorizationtype: apiKeydescription: Enter the token with Bearer schema prefix, eg. `Bearer <token-string>`in: header
- curl
- python
- go
- nodejs
- php
- CURL
curl -L 'https://api.one.blendvision.com/bv/account/v1/accounts/info' \
-H 'Accept: application/json' \
-H 'authorization: <API_KEY_VALUE>'
ResponseClear