メインコンテンツへスキップ
GET
curl
Didit の List Bank Connections エンドポイントは、ステータス、アクセス、銀行、国、お客様独自の参照ID、同意の終了日でフィルタリングした接続を返します。 同意の更新が必要な同意を見つけるにはconsent_expires_beforeを、特定のエンドユーザーの接続を見つけるにはend_user_referenceを使用します。 一覧はcursorを使ってページ分割されます。

承認

x-api-key
string
header
必須

お客様のアプリケーションの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 を参照してください。

クエリパラメータ

status
enum<string>

このステータスの接続のみ。

利用可能なオプション:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

このアクセスモードのみ。

利用可能なオプション:
one_time,
ongoing
institution_id
string

この銀行のみ。

Maximum string length: 64
country
string

この国の銀行のみ。

Pattern: ^[A-Z]{3}$
vendor_data
string

vendor_data がこの値の接続のみ。

Maximum string length: 255
end_user_reference
string

end_user.reference がこの値の接続のみ。

Maximum string length: 255

同意の期限がこの時刻より前に終わる接続のみ。例えば更新リンクを送信する場合に使います。

created_after
string<date-time>

この時刻より後に作成された接続のみ。

limit
integer
デフォルト:100

ページサイズ。1〜500。デフォルトは100。

必須範囲: 1 <= x <= 500
cursor
string

前のページの next_cursor から取得した不透明なカーソル。

レスポンス

接続のページです。

接続のページです。

items
object[]
必須
next_cursor
string | null
必須

次のページを取得するには cursor としてこの値を渡します。最後のページでは null になります。

最終更新日 2026年11月22日