메인 콘텐츠로 건너뛰기
GET
curl
Didit의 Get an Institution endpoint는 은행 한 곳의 기능과 상태를 반환합니다. 관측된 적이 없는 값은 추측하지 않고 null로 표시합니다.

인증

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 를 참조합니다.

경로 매개변수

id
string
필수

기관 ID입니다(예: es-banco-norte).

응답

은행입니다.

은행과 지원 기능입니다. 값은 관측된 기능 데이터에서 가져오며 매일 갱신됩니다. 한 번도 관측되지 않은 값은 추측값이 아니라 null입니다.

id
string
필수

은행을 식별하는 Didit 식별자이며 안정적인 슬러그입니다.

예시:

"es-banco-norte"

name
string
필수
country
string
필수
Pattern: ^[A-Z]{3}$
logo_url
string<uri> | null
필수
timezone
string | null
필수

은행 날짜가 사용하는 IANA 시간대입니다.

segments
enum<string>[]
필수
사용 가능한 옵션:
personal,
business
access
enum<string>[]
필수

ongoing은 해당 은행에서 지속적인 접근이 활성화된 경우에만 표시됩니다.

사용 가능한 옵션:
one_time,
ongoing
ongoing_access
boolean
필수

이 은행에서 지속적인 접근이 가능한지 여부입니다.

은행이 허용하는 가장 긴 동의 기간(일 단위)입니다. 관측되지 않은 경우 null입니다.

history_days_max
integer | null
필수

은행이 제공하는 가장 긴 이력 기간(일 단위)입니다. 관측되지 않은 경우 null입니다.

pending_transactions
boolean | null
필수

은행이 대기 중 거래를 보고하는지 여부입니다.

pending_linkage
boolean | null
필수

은행이 대기 중 거래를 확정된 거래와 연결하는지 여부입니다. 이 연결이 pending_id를 설정합니다.

balance_types
enum<string>[]
필수
사용 가능한 옵션:
booked,
available,
expected
transaction_fields
string[]
필수

은행이 전송하는 것으로 알려진 거래 필드입니다. 그 밖의 모든 필드는 null입니다.

sign_in
enum<string> | null
필수

사용자가 은행에 로그인하는 방식입니다.

사용 가능한 옵션:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
필수

Bank Link에서 사용자에게 인증된 이메일 주소가 필요한지 여부입니다.

corporate_accounts
boolean | null
필수

법인 계좌 지원 여부입니다.

bank_account_selection
boolean | null
필수

사용자가 Bank Link가 아닌 은행에서 계좌를 선택하는지 여부입니다.

은행이 이전 이력을 공개하기 위해 추가 확인을 한 번 더 요구하는지 여부입니다.

reconfirmation
boolean | null
필수

갱신을 은행 로그인 없이 Didit 화면에서 다시 확인할 수 있는지 여부입니다.

sync_frequency_hours
integer | null
필수

은행이 더 빠른 주기를 허용하는 경우 자동 동기화 사이의 시간(시간 단위)입니다. null은 일일 기본값을 의미합니다.

health
enum<string>
필수
사용 가능한 옵션:
operational,
degraded,
down
마지막 수정일 2026년 11월 22일