curl
curl 'https://verification.didit.me/v3/bank/connections/?status=active&country=ESP&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_connections()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listConnections();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListConnections(ctx, didit.BankListConnectionsParams{})
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().listConnections();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listConnections();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_connections
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.ListConnectionsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"environment": "live",
"access": "ongoing",
"status": "active",
"status_reason": null,
"institution": {
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png"
},
"segment": "business",
"data": [
"accounts",
"balances",
"transactions"
],
"consent": {
"status": "granted",
"version": 1,
"granted_at": "2026-11-21T12:04:11Z",
"expires_at": "2027-05-20T12:04:11Z",
"days_granted": 180,
"renewed_count": 0,
"scopes_requested": [
"accounts",
"balances",
"transactions"
],
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"accounts_granted": [
"a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72"
],
"renewal_action": "bank_auth",
"renew_by": "2027-05-20T12:04:11Z",
"reconfirm_by": null,
"renewable_until": null,
"retain_until": null,
"ended_at": null,
"ended_by": null
},
"sync": {
"status": "ok",
"initial_status": "succeeded",
"initial_complete": true,
"history_complete": true,
"last_synced_at": "2026-11-21T12:04:40Z",
"next_sync_at": "2026-11-22T06:00:00Z",
"budgets": [
{
"scope": "connection",
"resource": "all",
"limit": 4,
"remaining": 3,
"resets_at": "2026-11-22T00:00:00Z"
}
],
"last_error": null,
"frequency_per_day": 1,
"live_syncs_left_today": 3
},
"accounts": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"name": "Cuenta negocio",
"type": "current",
"usage": "business",
"currency": "EUR",
"iban_last4": "1332",
"status": "open"
},
{
"id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"name": "Cuenta de ahorro",
"type": "savings",
"usage": "business",
"currency": "EUR",
"iban_last4": "7708",
"status": "open"
}
],
"ownership": {
"compare": "none",
"match": null,
"check_id": null,
"result": null
},
"end_user": {
"reference": "client-7731"
},
"manage_url": null,
"billing": {
"unit": "connection_month",
"price_usd": "0.9000",
"billed_through": "2026-11-30"
},
"possible_duplicate_of": null,
"erasure": null,
"vendor_data": "client-7731",
"created_at": "2026-11-21T12:03:02Z",
"updated_at": "2026-11-21T12:04:40Z"
}
],
"next_cursor": null
}接続
銀行接続一覧API:ステータスと同意でフィルタリング
Didit の銀行接続一覧エンドポイントでは、ステータス、アクセス、銀行、国、独自の参照値、同意の終了日で絞り込んだ接続を取得できます。
GET
/
v3
/
bank
/
connections
/
curl
curl 'https://verification.didit.me/v3/bank/connections/?status=active&country=ESP&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_connections()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listConnections();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListConnections(ctx, didit.BankListConnectionsParams{})
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().listConnections();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listConnections();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_connections
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.ListConnectionsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"environment": "live",
"access": "ongoing",
"status": "active",
"status_reason": null,
"institution": {
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png"
},
"segment": "business",
"data": [
"accounts",
"balances",
"transactions"
],
"consent": {
"status": "granted",
"version": 1,
"granted_at": "2026-11-21T12:04:11Z",
"expires_at": "2027-05-20T12:04:11Z",
"days_granted": 180,
"renewed_count": 0,
"scopes_requested": [
"accounts",
"balances",
"transactions"
],
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"accounts_granted": [
"a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72"
],
"renewal_action": "bank_auth",
"renew_by": "2027-05-20T12:04:11Z",
"reconfirm_by": null,
"renewable_until": null,
"retain_until": null,
"ended_at": null,
"ended_by": null
},
"sync": {
"status": "ok",
"initial_status": "succeeded",
"initial_complete": true,
"history_complete": true,
"last_synced_at": "2026-11-21T12:04:40Z",
"next_sync_at": "2026-11-22T06:00:00Z",
"budgets": [
{
"scope": "connection",
"resource": "all",
"limit": 4,
"remaining": 3,
"resets_at": "2026-11-22T00:00:00Z"
}
],
"last_error": null,
"frequency_per_day": 1,
"live_syncs_left_today": 3
},
"accounts": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"name": "Cuenta negocio",
"type": "current",
"usage": "business",
"currency": "EUR",
"iban_last4": "1332",
"status": "open"
},
{
"id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"name": "Cuenta de ahorro",
"type": "savings",
"usage": "business",
"currency": "EUR",
"iban_last4": "7708",
"status": "open"
}
],
"ownership": {
"compare": "none",
"match": null,
"check_id": null,
"result": null
},
"end_user": {
"reference": "client-7731"
},
"manage_url": null,
"billing": {
"unit": "connection_month",
"price_usd": "0.9000",
"billed_through": "2026-11-30"
},
"possible_duplicate_of": null,
"erasure": null,
"vendor_data": "client-7731",
"created_at": "2026-11-21T12:03:02Z",
"updated_at": "2026-11-21T12:04:40Z"
}
],
"next_cursor": null
}Didit の List Bank Connections エンドポイントは、ステータス、アクセス、銀行、国、お客様独自の参照ID、同意の終了日でフィルタリングした接続を返します。
同意の更新が必要な同意を見つけるには
consent_expires_beforeを、特定のエンドユーザーの接続を見つけるにはend_user_referenceを使用します。
一覧はcursorを使ってページ分割されます。承認
お客様のアプリケーションのAPIキーです。Business Console の Developers -> API keys から取得できます。プライマリーキーはすべてのアクセス権を持ちます。名前付きキーは範囲を制限できます。リソースごとに none、read、write を指定でき、一部のワークフローや承認済みセッションに限定できます。IPアドレスのリストや有効期限も設定できます。401 はキーが誤っている、取り消されている、または期限切れであることを意味します。403 はキーが送信されていない、そのリソースまたはアクションへのアクセス権がない、またはリクエストがIPリストに含まれないアドレスから送信されたことを意味します。セッションのルートでの404 は、セッションがキーのワークフローまたはステータスの範囲外にあることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLが null で返されます。セッションの書き込み権限がないキーでは、セッションリンクとトークンが null で返されます。詳しくは https://docs.didit.me/console/api-keys を参照してください。
クエリパラメータ
最終更新日 2026年11月22日