# Get indicator field information

Get the field base information of the indicator

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/performance/v2/metric_fields/query
HTTP Method | POST
Rate Limit | [20 per minute](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App、Store App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.**<br>Enable any scope from the list | 管理关键指标数据(performance:metric:write)<br>获取指标配置信息(performance:metric_lib:read)<br>获取关键指标数据(performance:metric:read)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | Yes | **Fixed value**: "application/json; charset=utf-8"

### Request body

Parameter | Type | Required | Description
---|---|---|---
field_ids | string\[\] | No | The field ID of the indicator, if it is not passed, all field information will be obtained by default.<br>**Example value**: ["7293169069640630291"]<br>**Data validation rules**:<br>- Length range: `0` ～ `50`

### Request body example
```json
{
    "field_ids": [
        "7293169069640630291"
    ]
}
```

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
items | metric_field\[\] | Metric field information
field_id | string | Metric field information
name | i18n | field name
zh_cn | string | Chinese
en_us | string | English
type | string | field type<br>**Optional values are**:<br>- text：Text<br>- number：number<br>- pencentage：percentage<br>- person：personnel radio selection

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "field_id": "7272581996315099155",
                "name": {
                    "zh_cn": "体验",
                    "en_us": "Interactive experience"
                },
                "type": "text"
            }
        ]
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
500 | 1580101 | internal error | Internal error, please try again later, it still appears You can [consult customer service](https://applink.feishu.cn/client/helpdesk/open?id=6626260912531570952&extra=%7B%22channel%22%3A14%2C%22created_at%22%3A1614493146%2C%22scenario_id%22%3A6885151765134622721%2C%22signature%22%3A%22ca94c408b966dc1de2083e5bbcd418294c146e98%22%7D)
400 | 1580102 | param is invalid | The request parameter is wrong, check whether the request parameter is valid.
400 | 1580901 | tenant no licnese | The tenant has no performance seat, please contact the tenant administrator to open a performance seat.

For more information on error codes, see [Generic Error Code](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN).

