curl
curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/balances/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_balances(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getBalances("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetBalances(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getBalances("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getBalances('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_balances("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetBalancesAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"balances": [
{
"type": "booked",
"iso_type": "CLBD",
"amount": "18250.34",
"currency": "EUR",
"reference_date": "2026-11-20",
"last_change_at": "2026-11-20T22:10:00Z",
"credit_limit_included": false
},
{
"type": "available",
"iso_type": "ITAV",
"amount": "17990.34",
"currency": "EUR",
"reference_date": "2026-11-21",
"last_change_at": "2026-11-21T11:58:00Z",
"credit_limit_included": false
}
],
"last_synced_at": "2026-11-21T12:04:40Z"
}계좌 및 거래
계좌 잔액 조회 API: 장부 잔액과 사용 가능 잔액
Didit의 Get Account Balances 엔드포인트는 계좌의 유형별 잔액과 기준 날짜를 반환합니다.
GET
/
v3
/
bank
/
accounts
/
{account_id}
/
balances
/
curl
curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/balances/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_balances(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getBalances("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetBalances(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getBalances("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getBalances('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_balances("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetBalancesAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"balances": [
{
"type": "booked",
"iso_type": "CLBD",
"amount": "18250.34",
"currency": "EUR",
"reference_date": "2026-11-20",
"last_change_at": "2026-11-20T22:10:00Z",
"credit_limit_included": false
},
{
"type": "available",
"iso_type": "ITAV",
"amount": "17990.34",
"currency": "EUR",
"reference_date": "2026-11-21",
"last_change_at": "2026-11-21T11:58:00Z",
"credit_limit_included": false
}
],
"last_synced_at": "2026-11-21T12:04:40Z"
}Didit의 계좌 잔액 조회 endpoint는 유형별 잔액을 기준일과 함께 반환합니다.
type은 booked, available, expected 중 하나입니다.
조회는 절대 과금되지 않습니다.인증
귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.
마지막 수정일 2026년 11월 22일