メインコンテンツへスキップ
GET
curl
Diditの Get an Accountエンドポイントは、1件の口座について、識別子、口座名義人、同期の鮮度、履歴の取得範囲を返します。 sync.last_synced_atは、Diditが銀行から最後にデータを取得した時刻です。 完全な識別子を取得するには、APIキーに銀行データの権限が必要です。 口座、残高、取引を参照してください。

承認

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 を参照してください。

パスパラメータ

account_id
string<uuid>
必須

口座ID。

レスポンス

口座。

接続内の1つのアカウント。

id
string<uuid>
必須

アカウントID。接続に属し、存在する間は更新を含めて変わりません。

connection_id
string<uuid>
必須
name
string | null
必須
product
string | null
必須

銀行の商品名。

type
enum<string>
必須
利用可能なオプション:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
必須
利用可能なオプション:
personal,
business,
unknown
currency
string
必須

通貨コード(ISO4217)。

Pattern: ^[A-Z]{3}$
holder_name
string | null
必須

銀行が共有している場合の名義人名。

holders
object[]
必須

銀行が共有する名義人。所有者として数えられるのは holder と joint_holder のみです。

identifiers
object
必須

完全な識別子。銀行データの権限を持つサーバー側の呼び出し元に返されます。

account_ref
string | null
必須

同じアプリケーションおよび環境の接続をまたいで同じ銀行口座を識別します。銀行自身の識別子をキー付きハッシュにしたものです。銀行が信頼できる識別子を提供しない場合は null。既知の銀行口座を識別するために使用してください。

account_ref_previous
string | null
必須

以前のaccount_ref。銀行の移行など、検証済みのエイリアスの場合にのみ。

status
enum<string>
必須

access_removed: 本人が同意からアカウントを削除しました。以後、同期されません。

利用可能なオプション:
open,
closed,
access_removed
scopes_granted
enum<string>[]
必須
利用可能なオプション:
accounts,
balances,
transactions
sync
object
必須
history_coverage
object
必須

要求された履歴のうち、銀行が提供した分。

最終更新日 2026年11月22日