# Get account holder API

### Gets the account holder name for a bank account.

## Gets the account holder name for a bank account.

<mark style="color:blue;">`GET`</mark> `https://api.iamport.kr/vbanks/holder`

#### Query Parameters

| Name                                         | Type   | Description                                                                                                                      |
| -------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| bank\_code<mark style="color:red;">\*</mark> | String | <mark style="color:red;">**Bank code**</mark>                                                                                    |
| bank\_num<mark style="color:red;">\*</mark>  | String | <p><mark style="color:red;"><strong>Account number</strong></mark></p><p><code>Numbers and special characters allowed</code></p> |

{% tabs %}
{% tab title="200: OK Success" %}
{% tabs %}
{% tab title="VbankHolderResponse" %}
**`code`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:purple;">**integer**</mark>

**Response code**

0: success, Not 0: check the message

**`message`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:green;">**string**</mark>

**Response message**

A non-zero code includes a message like 'Invalid payment info'.

**response&#x20;**<mark style="color:red;">**(VbankHolderAnnotation, optional)**</mark>
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="VbankHolderAnnotation" %}
**`bank_holder`` `**<mark style="color:red;">**`*`**</mark>**` `**<mark style="color:green;">**`string`**</mark>

**`Account holder name`**
{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400: Bad Request Missing bank\_code" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="401: Unauthorized Missing or invalid access token" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="404: Not Found Request not found" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

<details>

<summary>Response Model Schema</summary>

```json
{
  "code": 0,
  "message": "string",
  "response": {
    "bank_holder": "string"
  }
}
```

</details>

{% hint style="success" %}
**Swagger Test Link**

[**https://api.iamport.kr/#!/vbanks/queryBankHolder**](https://api.iamport.kr/#!/vbanks/queryBankHolder)
{% endhint %}