Get Capacity Summary of a Company

Get the capacity summary of a company.

Request URL

GET {base_url}/uc-subscription/api/v1/subscription/quota-summary

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.
Path parameters
Parameter Required Type Description
ucid No String The UC ID of the company.
Note:
  • You can obtain the company UC ID using the Get the Current User or Search Resellers interfaces.
  • If this parameter is not specified, the company UC ID of the current logged-in user is used.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.
result Object<Capacity_Summary> The capacity summary.
Capacity_Summary
Parameter Type Description
ucId Integer The UC ID of the company.
services Array<Service> The list of services.

Service

Parameter Type Description
serviceKey String The service key.
  • novoone: NovoOne plan.
  • call_recording_srv: Call recording service.
  • white_label_srv: White label service.
  • transcription_srv: Transcription service.
  • ai_receptionist_srv: AI receptionist service (on-demand minute pack).
  • receptionist_pack_srv: AI receptionist service (monthly rolling plan).
  • geo_redundancy_srv: Geo redundancy service.
params Array<Service_Parameter> The list of service parameters.
expiryTime Integer The expiration time of the subscription, in Unix timestamp format (seconds).

Service_Parameter

Parameter Type Description
paramKey String The parameter key.
  • users: The number of tenant users.
  • tenants: The number of tenants.
  • concurrentCalls: The number of concurrent calls.
  • retentionTime: The retention period for recordings.
  • whiteLabel: The number of white label packs.
  • awsTranscription: The number of users who can use the transcription feature.
  • receptionist: The number of AI receptionist minutes.
  • receptionistPack: The number of AI receptionist monthly capacity packs.
  • geo: The geo redundancy capacity packs.
paramId String The ID of the parameter.
used Integer The used capacity.
Note: A value of -1 indicates that the capacity is unlimited.
total Integer The subscribed total capacity.
Note:
  • A value of -1 indicates that the capacity is unlimited.
  • This parameter does not include the bonus capacity.
available Integer The available capacity.
Note:
  • A value of -1 indicates that the capacity is unlimited.
  • This parameter does not include the bonus capacity.
unit String The unit of the parameter.
  • count
  • minute
packageValue Integer The value of the package.
packageUnit String The unit of the package.
  • min
  • day
  • month
  • year
visible Boolean Whether the parameter is visible on the portal.
  • true
  • false
bonus Integer The bonus capacity.
allocationDetails Object<Allocation_Details> The allocation details of the used capacity.

Allocation_Details

Parameter Type Description
selfColleagueUsed Integer The capacity assigned to your own tenants.
Note: A value of -1 indicates that the capacity is unlimited.
resellerAssigned Integer The capacity assigned to resellers.
Note: A value of -1 indicates that the capacity is unlimited.

Example

Request example

GET /uc-subscription/api/v1/subscription/quota-summary HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJjbi0wLWtleS0xIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJkaXN0cmlidXRvcmV4YW1wbGVAb3V0bG9vay5jb20iLCJhcHBfa2V5Ijoic2xOdnQzaHc1NXB2Vm5HRlNhR2ZOVTNmMWxYQ3lpa08iLCJncmFudF90eXBlIjoib3BlbmFwaSIsImNsaWVudF9leHQiOnsiZGVzY3JpcHRpb24iOiLnrKzkuInmlrnlkIjkvZzkvJnkvLTlupTnlKgiLCJwYXJ0bmVyIjoi56S65L6L5ZCI5L2c5LyZ5Ly0In0sImNsaWVudF90eXBlIjoib3BlbmFwaSIsImV4cCI6MTc5MjU2MzM1MywiaWF0IjoxNzkyNTQxNzUzLCJqdGkiOiIyZjRmYzAwMy0zNjNlLTQxYTMtOGNjMy02YTc4ODkyM2RkMDUiLCJjbGllbnRfaWQiOiJub3ZvLW9wZW4tcGxhdGZvcm0iLCJ1c2VyX2V4dCI6eyJyb2xlSWRzIjpbM10sInN0eXBlIjoiQURNSU4iLCJ0ZW5hbnRDb2RlIjpudWxsLCJ0eXBlIjoiUF9BQ0NPVU5UIiwidXNlcklkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJlbWFpbCI6ImRpc3RyaWJ1dG9yZXhhbXBsZUBvdXRsb29rLmNvbSIsInVzZXJuYW1lIjoiZGlzdHJpYnV0b3JleGFtcGxlQG91dGxvb2suY29tIiwidWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5Nn19.sUhcJCOi1PPz45Z88LE4MfHFifCWwnFMmpaWrIfaCLJa6f-hHf4-n4YYS1hThBtQ63D25-p-ZF-K584n3y9LKztUqaEHvI1GMmhTEJEx13EId56H0MUrxKdQEQM1MwKmTD_CAW2jh3IN3bs3LFJRIF8AUB6qoyNZGU-4nnFVS3OZlK2CcAyUiT-JiKpJpoOzluNdUI4lIcgYRUsycXtmSrf0pZuZbN-hRRpdx64S-HV4ZSKRNA34Utpgy7ZmeXyIxaVNOWKwTZyXd8SM6GXn2Br1KO7U_jOXaikQQfvZPvv_2vtKVTq-i3IflwbwhiqG2xJT9MhXDR4VWz0if3B8pg

Response example

HTTP/1.1 200 OK
{
    "result": {
        "ucId": "3076913644890832896",
        "services": [
            {
                "serviceKey": "novoone",
                "params": [
                    {
                        "paramKey": "users",
                        "paramId": "bb75920690924186a37f73f7ac29618d",
                        "used": 282,
                        "total": 1026,
                        "available": 744,
                        "unit": "count",
                        "allocationDetails": {
                            "selfColleagueUsed": 254,
                            "resellerAssigned": 28
                        }
                    },
                    {
                        "paramKey": "tenants",
                        "paramId": "1581cbc2-8079-41f6-9251-0380cdef0ca8",
                        "used": -1,
                        "total": -1,
                        "available": -1,
                        "unit": "count",
                        "allocationDetails": {
                            "selfColleagueUsed": 0,
                            "resellerAssigned": -1
                        }
                    },
                    {
                        "paramKey": "concurrentCalls",
                        "paramId": "088f83b467274c5b8e3c0ec38520785d",
                        "used": -1,
                        "total": -1,
                        "available": -1,
                        "unit": "count",
                        "allocationDetails": {
                            "selfColleagueUsed": -1,
                            "resellerAssigned": -1
                        }
                    }
                ],
                "expireTime": 1841119906000
            },
            {
                "serviceKey": "white_label_srv",
                "params": [
                    {
                        "paramKey": "whiteLabel",
                        "paramId": "83e255d76f064d0e8d745b4d0c04a6af",
                        "used": 4,
                        "total": 10,
                        "available": 6,
                        "unit": "count",
                        "allocationDetails": {
                            "selfColleagueUsed": 1,
                            "resellerAssigned": 3
                        }
                    }
                ],
                "expireTime": 1841119906000
            },
            {
                "serviceKey": "transcription_srv",
                "params": [
                    {
                        "paramKey": "awsTranscription",
                        "paramId": "e92e018c708748af82c772c983551ce9",
                        "used": 13,
                        "total": 13,
                        "available": 0,
                        "unit": "count",
                        "allocationDetails": {
                            "selfColleagueUsed": 12,
                            "resellerAssigned": 1
                        }
                    }
                ],
                "expireTime": 1841119906000
            },
            {
                "serviceKey": "call_recording_srv",
                "params": [
                    {
                        "paramKey": "retentionTime",
                        "paramId": "fa43ea3f65294df18d16c024f619a958",
                        "used": 5,
                        "total": 18,
                        "available": 13,
                        "unit": "count",
                        "packageValue": 1,
                        "packageUnit": "year",
                        "allocationDetails": {
                            "selfColleagueUsed": 3,
                            "resellerAssigned": 2
                        }
                    },
                    {
                        "paramKey": "retentionTime",
                        "paramId": "57348aa04ab942179e06e311d4229e3c",
                        "used": 12,
                        "total": 31,
                        "available": 19,
                        "unit": "count",
                        "packageValue": 1,
                        "packageUnit": "month",
                        "allocationDetails": {
                            "selfColleagueUsed": 12,
                            "resellerAssigned": 2
                        }
                    }
                ],
                "expireTime": 1841119906000
            },
            {
                "serviceKey": "ai_receptionist_srv",
                "params": [
                    {
                        "paramKey": "receptionist",
                        "paramId": "6b9413b6f0874eb2994ee0664b133f5f",
                        "used": 1102,
                        "total": 3000,
                        "available": 1898,
                        "unit": "minute",
                        "bonus": 60,
                        "allocationDetails": {
                            "selfColleagueUsed": 1002,
                            "resellerAssigned": 100
                        }
                    }
                ],
                "expireTime": 4070880000000
            },
            {
                "serviceKey": "receptionist_pack_srv",
                "params": [
                    {
                        "paramKey": "receptionistPack",
                        "paramId": "75984724e7b94680853e8740fe0c937a",
                        "used": 3,
                        "total": 3,
                        "available": 0,
                        "unit": "count",
                        "packageValue": 300,
                        "packageUnit": "min",
                        "allocationDetails": {
                            "selfColleagueUsed": 1,
                            "resellerAssigned": 2
                        }
                    }
                ],
                "expireTime": 1822959320000
            }
        ]
    },
    "requestId": "dad67f82b32c7c2c7bfca14109372e78",
    "code": "200",
    "message": "SUCCESS"
}