메인 콘텐츠로 건너뛰기
GET
curl
Didit의 계좌 조회(Get an Account) 엔드포인트는 계좌 하나를 반환하며, 여기에는 식별자, 명의자, 동기화 최신 상태와 이력 범위가 포함됩니다. sync.last_synced_at은 Didit이 은행에서 마지막으로 데이터를 가져온 시점입니다. 전체 식별자를 확인하려면 API 키에 은행 데이터 권한이 있어야 합니다. 자세한 내용은 계좌, 잔액 및 거래를 참고하십시오.

인증

x-api-key
string
header
필수

귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.

경로 매개변수

account_id
string<uuid>
필수

계좌 ID입니다.

응답

계좌입니다.

연결 내의 계좌 하나입니다.

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
필수

ISO 4217 통화 코드입니다.

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일