Bulk Inquire Bank Account Holders
Look up the account holder names for 1 to 100 accounts at once. The API returns one result per account in the order you sent them. An account with no holder has holderName set to null and the cause in error.
If no account is verified at all, the API returns 503 instead of this response. Bank account holder guide
POST
/
v1
/
bankAccountHolders:bulkInquire
Bulk Inquire Bank Account Holders
curl --request POST \
--url https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"accounts": [
{
"bankCode": "088",
"accountNumber": "1000000001"
},
{
"bankCode": "089",
"accountNumber": "1000000004"
}
]
}
'import requests
url = "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire"
payload = { "accounts": [
{
"bankCode": "088",
"accountNumber": "1000000001"
},
{
"bankCode": "089",
"accountNumber": "1000000004"
}
] }
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accounts: [
{bankCode: '088', accountNumber: '1000000001'},
{bankCode: '089', accountNumber: '1000000004'}
]
})
};
fetch('https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'accounts' => [
[
'bankCode' => '088',
'accountNumber' => '1000000001'
],
[
'bankCode' => '089',
'accountNumber' => '1000000004'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire"
payload := strings.NewReader("{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"bankCode": "088",
"accountNumber": "1000000001",
"holderName": "홍길동",
"error": null
},
{
"bankCode": "089",
"accountNumber": "1000000004",
"holderName": null,
"error": {
"code": "AMOUNT_REQUIRED",
"message": "입금 금액이 정해진 가상계좌입니다. 총 지급 금액을 입력한 뒤 예금주를 다시 조회해 주세요."
}
}
]
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}Authorizations
Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.
Body
application/json
Bulk account holder inquiry request
Accounts to look up. Send 1 to 100 accounts.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Response
One result per account, in the order you sent them.
Bulk account holder lookup result
One item per requested account, in the order you sent them.
Required array length:
1 - 100 elementsLookup result for one account
- Option 1
- Option 2
Show child attributes
Show child attributes
Bulk Inquire Bank Account Holders
curl --request POST \
--url https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"accounts": [
{
"bankCode": "088",
"accountNumber": "1000000001"
},
{
"bankCode": "089",
"accountNumber": "1000000004"
}
]
}
'import requests
url = "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire"
payload = { "accounts": [
{
"bankCode": "088",
"accountNumber": "1000000001"
},
{
"bankCode": "089",
"accountNumber": "1000000004"
}
] }
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
accounts: [
{bankCode: '088', accountNumber: '1000000001'},
{bankCode: '089', accountNumber: '1000000004'}
]
})
};
fetch('https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'accounts' => [
[
'bankCode' => '088',
'accountNumber' => '1000000001'
],
[
'bankCode' => '089',
'accountNumber' => '1000000004'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire"
payload := strings.NewReader("{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/bankAccountHolders:bulkInquire")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accounts\": [\n {\n \"bankCode\": \"088\",\n \"accountNumber\": \"1000000001\"\n },\n {\n \"bankCode\": \"089\",\n \"accountNumber\": \"1000000004\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"bankCode": "088",
"accountNumber": "1000000001",
"holderName": "홍길동",
"error": null
},
{
"bankCode": "089",
"accountNumber": "1000000004",
"holderName": null,
"error": {
"code": "AMOUNT_REQUIRED",
"message": "입금 금액이 정해진 가상계좌입니다. 총 지급 금액을 입력한 뒤 예금주를 다시 조회해 주세요."
}
}
]
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}