# 查询个人版套餐

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetPersonalPlan&Version=2024-01-01`

查询当前账号已购买的个人版套餐信息，包含套餐档位、生效状态、起止时间、自动续费设置等。

> **说明：注意**
>
> 该接口仅返回当前账号已购买的个人版套餐信息，未购买或套餐已回收时会返回 ResourceNotFound.Plan 错误。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**Plan** `string` `必选` | 商品名称

待查询的商品名称。可选值：`AgentPlan`、`CodingPlan`。

## 响应参数

**AutoRenew** `boolean` | 自动续费

是否已开启到期自动续费。

**EndTime** `string` | 到期时间

套餐当前到期时间，ISO 8601 格式。

**PlanType** `string` | 套餐档位

当前账号已订购的套餐档位。*Plan* 为 `AgentPlan` 时取值 `Small`、`Medium`、`Large`、`Max`；*Plan* 为 `CodingPlan` 时取值 `Lite`、`Pro`。

**StartTime** `string` | 生效时间

套餐首次生效时间，ISO 8601 格式。

**Status** `string` | 套餐状态

套餐的当前生效状态。`Running` 表示生效中，`Expired` 表示已过期。


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetPersonalPlan&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "Plan": "AgentPlan"
}
'
```

#### Response

```
{
    "ResponseMetadata": {
        "RequestId": "20260101120000D7E3F2B481A5C90463",
        "Action": "GetPersonalPlan",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "PlanType": "Small",
        "Status": "Running",
        "StartTime": "2025-01-01T00:00:00+08:00",
        "EndTime": "2026-01-01T00:00:00+08:00",
        "AutoRenew": false
    }
}
```