# Tencent Cloud Billing Center API

> Tencent Cloud Billing Center API on Apizie: 71 endpoints (Create Allocation Rule, Create Allocation Tag, Create Allocation Unit, Create Budget, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:tencent-billing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-billing`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-billing
- OpenAPI: https://apizie.tech/api/cloud/tencent-billing/openapi.json

Tencent Cloud API 3.0 for Billing Center (billing). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Create Allocation Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/create-allocation-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleList | object | yes |  |
| Month | string | no |  |

### Create Allocation Tag
`POST https://apizie.tech/v1/cloud:tencent-billing/create-allocation-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TagKey | array | yes |  |

### Create Allocation Unit
`POST https://apizie.tech/v1/cloud:tencent-billing/create-allocation-unit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ParentId | integer | yes |  |
| Name | string | no |  |
| Month | string | no |  |

### Create Budget
`POST https://apizie.tech/v1/cloud:tencent-billing/create-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BudgetName | string | yes |  |
| CycleType | string | yes |  |
| PeriodBegin | string | yes |  |
| PeriodEnd | string | yes |  |
| PlanType | string | yes |  |
| BudgetQuota | string | yes |  |
| BillType | string | yes |  |
| FeeType | string | yes |  |
| WarnJson | array | yes |  |
| BudgetNote | string | no |  |
| DimensionsRange | object | no |  |
| WaveThresholdJson | array | no |  |

### Create Gather Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/create-gather-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| RuleList | object | yes |  |
| Month | string | no |  |

### Create Instance
`POST https://apizie.tech/v1/cloud:tencent-billing/create-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClientToken | string | yes |  |
| ProductCode | string | yes |  |
| SubProductCode | string | yes |  |
| RegionCode | string | yes |  |
| ZoneCode | string | yes |  |
| PayMode | string | yes |  |
| Parameter | string | yes |  |
| Quantity | integer | no |  |
| ProjectId | integer | no |  |
| Period | integer | no |  |
| PeriodUnit | string | no |  |
| RenewFlag | string | no |  |

### Delete Allocation Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/delete-allocation-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | integer | yes |  |
| Month | string | no |  |

### Delete Allocation Tag
`POST https://apizie.tech/v1/cloud:tencent-billing/delete-allocation-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TagKey | array | yes |  |

### Delete Allocation Unit
`POST https://apizie.tech/v1/cloud:tencent-billing/delete-allocation-unit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| Month | string | no |  |

### Delete Budget
`POST https://apizie.tech/v1/cloud:tencent-billing/delete-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BudgetIds | array | yes |  |

### Delete Gather Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/delete-gather-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | integer | yes |  |
| Month | string | no |  |

### Describe Account Balance
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-account-balance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TempCredit | boolean | no |  |

### Describe Account Warning
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-account-warning` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Describe Allocate Conditions
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocate-conditions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | no |  |

### Describe Allocation Bill Conditions
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-bill-conditions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| BillDates | array | no |  |
| BusinessCodes | array | no |  |
| OwnerUins | array | no |  |
| OperateUins | array | no |  |
| PayModes | array | no |  |
| ActionTypes | array | no |  |
| ProductCodes | array | no |  |
| RegionIds | array | no |  |
| ZoneIds | array | no |  |
| InstanceTypes | array | no |  |
| Tag | array | no |  |
| ComponentCodes | array | no |  |
| ItemCodes | array | no |  |
| SearchKey | string | no |  |
| ProjectIds | array | no |  |
| AllocationType | array | no |  |

### Describe Allocation Bill Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-bill-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| Sort | string | no |  |
| SortType | string | no |  |
| BusinessCodes | array | no |  |
| OwnerUins | array | no |  |
| OperateUins | array | no |  |
| PayModes | array | no |  |
| ActionTypes | array | no |  |
| ProductCodes | array | no |  |
| RegionIds | array | no |  |
| ZoneIds | array | no |  |
| InstanceTypes | array | no |  |
| Tag | array | no |  |
| ComponentCodes | array | no |  |
| ItemCodes | array | no |  |
| SearchKey | string | no |  |
| ProjectIds | array | no |  |

### Describe Allocation Month Overview
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-month-overview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | no |  |

### Describe Allocation Overview
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-overview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| PeriodType | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| Sort | string | no |  |
| SortType | string | no |  |
| BillDates | array | no |  |

### Describe Allocation Rule Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-rule-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | integer | yes |  |
| Month | string | no |  |

### Describe Allocation Rule Summary
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-rule-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| Type | integer | no |  |
| Name | string | no |  |

### Describe Allocation Summary By Business
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-summary-by-business` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| PeriodType | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| SortType | string | no |  |
| Sort | string | no |  |
| BillDates | array | no |  |
| BusinessCodes | array | no |  |

### Describe Allocation Summary By Item
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-summary-by-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| PeriodType | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| Sort | string | no |  |
| SortType | string | no |  |
| BillDates | array | no |  |
| BusinessCodes | array | no |  |
| OwnerUins | array | no |  |
| OperateUins | array | no |  |
| PayModes | array | no |  |
| ActionTypes | array | no |  |
| ProductCodes | array | no |  |
| RegionIds | array | no |  |
| ZoneIds | array | no |  |
| InstanceTypes | array | no |  |
| Tag | array | no |  |
| ComponentCodes | array | no |  |
| ItemCodes | array | no |  |
| SearchKey | string | no |  |
| ProjectIds | array | no |  |
| AllocationType | array | no |  |

### Describe Allocation Summary By Resource
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-summary-by-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| PeriodType | string | no |  |
| TreeNodeUniqKeys | array | no |  |
| Sort | string | no |  |
| SortType | string | no |  |
| BillDates | array | no |  |
| BusinessCodes | array | no |  |
| OwnerUins | array | no |  |
| OperateUins | array | no |  |
| PayModes | array | no |  |
| ActionTypes | array | no |  |
| ProductCodes | array | no |  |
| RegionIds | array | no |  |
| ZoneIds | array | no |  |
| InstanceTypes | array | no |  |
| Tag | array | no |  |
| SearchKey | string | no |  |
| ProjectIds | array | no |  |
| AllocationType | array | no |  |

### Describe Allocation Tree
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-tree` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | no |  |

### Describe Allocation Trend By Month
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-trend-by-month` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | yes |  |
| TreeNodeUniqKey | string | yes |  |
| BusinessCode | string | no |  |

### Describe Allocation Unit Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-allocation-unit-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| Month | string | no |  |

### Describe Bill Adjust Info
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-adjust-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | no |  |
| TimeFrom | string | no |  |
| TimeTo | string | no |  |
| PayerUin | string | no |  |

### Describe Bill Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Month | string | no |  |
| BeginTime | string | no |  |
| EndTime | string | no |  |
| NeedRecordNum | integer | no |  |
| PayMode | string | no |  |
| ResourceId | string | no |  |
| ActionType | string | no |  |
| ProjectId | integer | no |  |
| BusinessCode | string | no |  |
| Context | string | no |  |
| PayerUin | string | no |  |

### Describe Bill Detail For Organization
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-detail-for-organization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Month | string | no |  |
| BeginTime | string | no |  |
| EndTime | string | no |  |
| NeedRecordNum | integer | no |  |
| PayMode | string | no |  |
| ResourceId | string | no |  |
| ActionType | string | no |  |
| ProjectId | integer | no |  |
| BusinessCode | string | no |  |
| Context | string | no |  |

### Describe Bill Download Url
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileType | string | yes |  |
| Month | string | yes |  |
| ChildUin | array | no |  |

### Describe Bill List
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTime | string | yes |  |
| EndTime | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| PayType | array | no |  |
| SubPayType | array | no |  |
| WithZeroAmount | integer | no |  |

### Describe Bill Resource Summary
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-resource-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Month | string | yes |  |
| NeedRecordNum | integer | no |  |
| ActionType | string | no |  |
| ResourceId | string | no |  |
| PayMode | string | no |  |
| BusinessCode | string | no |  |
| PayerUin | string | no |  |
| TagKey | string | no |  |
| TagValue | string | no |  |

### Describe Bill Resource Summary For Organization
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-resource-summary-for-organization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| Month | string | yes |  |
| NeedRecordNum | integer | no |  |
| ActionType | string | no |  |
| ResourceId | string | no |  |
| PayMode | string | no |  |
| BusinessCode | string | no |  |
| TagKey | string | no |  |
| TagValue | string | no |  |

### Describe Bill Summary
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | yes |  |
| GroupType | string | yes |  |
| TagKey | array | no |  |
| OperateUin | string | no |  |
| PayerUin | string | no |  |

### Describe Bill Summary By Pay Mode
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-by-pay-mode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| PayerUin | string | no |  |

### Describe Bill Summary By Product
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-by-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| PayerUin | string | no |  |
| PayType | string | no |  |

### Describe Bill Summary By Project
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-by-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| PayerUin | string | no |  |

### Describe Bill Summary By Region
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-by-region` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| PayerUin | string | no |  |

### Describe Bill Summary By Tag
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-by-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| TagKey | string | yes |  |
| PayerUin | string | no |  |
| TagValue | string | no |  |

### Describe Bill Summary For Organization
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-bill-summary-for-organization` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Month | string | yes |  |
| GroupType | string | yes |  |
| TagKey | array | no |  |

### Describe Budget
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNo | integer | yes |  |
| PageSize | integer | yes |  |
| BudgetId | string | no |  |
| BudgetName | string | no |  |
| BudgetStatus | string | no |  |
| CycleTypes | array | no |  |

### Describe Budget Operation Log
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-budget-operation-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNo | integer | yes |  |
| PageSize | integer | yes |  |
| BudgetId | string | yes |  |

### Describe Budget Remind Record List
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-budget-remind-record-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNo | integer | yes |  |
| PageSize | integer | yes |  |
| BudgetId | string | yes |  |

### Describe Cost Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| BeginTime | string | no |  |
| EndTime | string | no |  |
| NeedRecordNum | integer | no |  |
| Month | string | no |  |
| ProductCode | string | no |  |
| PayMode | string | no |  |
| ResourceId | string | no |  |
| BusinessCode | string | no |  |
| ProjectId | string | no |  |
| RegionId | string | no |  |

### Describe Cost Explorer Summary
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-explorer-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| BillType | string | yes |  |
| PeriodType | string | yes |  |
| Dimensions | string | yes |  |
| FeeType | string | yes |  |
| PageSize | integer | yes |  |
| PageNo | integer | yes |  |
| TagKeyStr | string | no |  |
| NeedConditionValue | string | no |  |
| Conditions | object | no |  |

### Describe Cost Summary By Product
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-summary-by-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| PayerUin | string | no |  |
| NeedRecordNum | integer | no |  |

### Describe Cost Summary By Project
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-summary-by-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| PayerUin | string | no |  |
| NeedRecordNum | integer | no |  |

### Describe Cost Summary By Region
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-summary-by-region` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| PayerUin | string | no |  |
| NeedRecordNum | integer | no |  |

### Describe Cost Summary By Resource
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-summary-by-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| PayerUin | string | no |  |
| NeedRecordNum | integer | no |  |
| NeedConditionValue | integer | no |  |
| Conditions | object | no |  |
| TagKey | string | no |  |
| TagValue | string | no |  |

### Describe Cost Summary By Tag
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-cost-summary-by-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | string | yes |  |
| EndTime | string | yes |  |
| TagKey | string | yes |  |

### Describe Deals By Cond
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-deals-by-cond` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTime | string | yes |  |
| EndTime | string | yes |  |
| Limit | integer | yes |  |
| Offset | integer | no |  |
| Status | integer | no |  |
| OrderId | string | no |  |
| BigDealId | string | no |  |
| ResourceId | string | no |  |
| StatusSet | array | no |  |

### Describe Dosage Cos Detail By Date
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-dosage-cos-detail-by-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartDate | string | yes |  |
| EndDate | string | yes |  |
| BucketName | string | yes |  |

### Describe Dosage Detail By Date
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-dosage-detail-by-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartDate | string | yes |  |
| EndDate | string | yes |  |
| ProductCode | string | yes |  |
| Domain | string | yes |  |
| InstanceID | string | no |  |
| PayerUin | string | no |  |

### Describe Dosage Detail List
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-dosage-detail-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTime | string | yes |  |
| EndTime | string | yes |  |
| ProductCode | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| DosageType | string | no |  |

### Describe Gather Resource
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-gather-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Month | string | no |  |
| TreeNodeUniqKey | string | no |  |
| GatherType | string | no |  |
| Sort | string | no |  |
| SortType | string | no |  |
| BusinessCodes | array | no |  |
| ProductCodes | array | no |  |
| ItemCodes | array | no |  |
| RegionIds | array | no |  |
| InstanceTypes | array | no |  |
| PayModes | array | no |  |
| OperateUins | array | no |  |
| OwnerUins | array | no |  |
| SearchKey | string | no |  |
| Tag | array | no |  |
| ProjectIds | array | no |  |
| ActionTypes | array | no |  |

### Describe Gather Rule Detail
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-gather-rule-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| Month | string | no |  |

### Describe Org Member Account Balance
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-org-member-account-balance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNumber | integer | no |  |
| PageSize | integer | no |  |
| MemberUins | array | no |  |

### Describe Renew Instances
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-renew-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MaxResults | integer | yes |  |
| NextToken | string | no |  |
| Reverse | boolean | no |  |
| RenewFlagList | array | no |  |
| InstanceIdList | array | no |  |
| ExpireTimeStart | string | no |  |
| ExpireTimeEnd | string | no |  |

### Describe Saving Plan Resource Info
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-saving-plan-resource-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| CreateStartDate | string | no |  |
| CreateEndDate | string | no |  |

### Describe Tag List
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-tag-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| TagKey | string | no |  |
| Status | integer | no |  |
| OrderType | string | no |  |

### Describe Voucher Info
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-voucher-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| Status | string | no |  |
| VoucherId | string | no |  |
| CodeId | string | no |  |
| ProductCode | string | no |  |
| ActivityId | string | no |  |
| VoucherName | string | no |  |
| TimeFrom | string | no |  |
| TimeTo | string | no |  |
| SortField | string | no |  |
| SortOrder | string | no |  |
| PayMode | string | no |  |
| PayScene | string | no |  |
| Operator | string | no |  |
| VoucherMainType | string | no |  |
| VoucherSubType | string | no |  |
| StartTimeFrom | string | no |  |
| StartTimeTo | string | no |  |
| EndTimeFrom | string | no |  |
| EndTimeTo | string | no |  |
| CreateTimeFrom | string | no |  |
| CreateTimeTo | string | no |  |
| Lang | string | no |  |

### Describe Voucher Usage Details
`POST https://apizie.tech/v1/cloud:tencent-billing/describe-voucher-usage-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |
| VoucherId | string | yes |  |
| Operator | string | no |  |

### Modify Account Warning
`POST https://apizie.tech/v1/cloud:tencent-billing/modify-account-warning` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Threshold | integer | yes |  |
| Open | integer | yes |  |

### Modify Allocation Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/modify-allocation-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | integer | yes |  |
| Name | string | yes |  |
| Type | integer | yes |  |
| RuleDetail | object | yes |  |
| RatioDetail | array | no |  |
| Month | string | no |  |

### Modify Allocation Unit
`POST https://apizie.tech/v1/cloud:tencent-billing/modify-allocation-unit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| Name | string | no |  |
| SourceName | string | no |  |
| SourceId | string | no |  |
| Remark | string | no |  |
| Month | string | no |  |

### Modify Budget
`POST https://apizie.tech/v1/cloud:tencent-billing/modify-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BudgetId | string | yes |  |
| BudgetName | string | yes |  |
| CycleType | string | yes |  |
| PeriodBegin | string | yes |  |
| PeriodEnd | string | yes |  |
| PlanType | string | yes |  |
| BudgetQuota | string | yes |  |
| BillType | string | yes |  |
| FeeType | string | yes |  |
| WarnJson | array | yes |  |
| BudgetNote | string | no |  |
| DimensionsRange | object | no |  |
| WaveThresholdJson | array | no |  |

### Modify Gather Rule
`POST https://apizie.tech/v1/cloud:tencent-billing/modify-gather-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Id | integer | yes |  |
| RuleDetail | object | yes |  |
| Month | string | no |  |

### Pay Deals
`POST https://apizie.tech/v1/cloud:tencent-billing/pay-deals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| OrderIds | array | no |  |
| AutoVoucher | integer | no |  |
| VoucherIds | array | no |  |
| BigDealIds | array | no |  |
| AgentPay | integer | no |  |
| CpsUin | string | no |  |

### Refund Instance
`POST https://apizie.tech/v1/cloud:tencent-billing/refund-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClientToken | string | yes |  |
| ProductCode | string | yes |  |
| SubProductCode | string | yes |  |
| InstanceId | string | yes |  |
| RegionCode | string | yes |  |

### Renew Instance
`POST https://apizie.tech/v1/cloud:tencent-billing/renew-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClientToken | string | yes |  |
| ProductCode | string | yes |  |
| SubProductCode | string | yes |  |
| RegionCode | string | yes |  |
| InstanceId | string | yes |  |
| Period | integer | no |  |
| PeriodUnit | string | no |  |

### Set Renewal
`POST https://apizie.tech/v1/cloud:tencent-billing/set-renewal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProductCode | string | yes |  |
| RegionCode | string | yes |  |
| InstanceId | string | yes |  |
| RenewFlag | string | yes |  |
| RenewPeriod | string | no |  |
| RenewPeriodUnit | string | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-billing/create-allocation-rule" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Billing Center API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-billing/create-allocation-rule with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Billing Center API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Billing Center itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Billing Center API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-billing.

### What is the status of the Tencent Cloud Billing Center API?
Needs your own provider key (bring your own key)