메인 콘텐츠로 건너뛰기
GET
curl
이 엔드포인트는 Business Console의 분석 대시보드에 표시되는 수치를 반환합니다. 응답 형식은 두 가지입니다. 모든 위젯에는 kind와 title이 포함되며, 나머지 필드는 위젯 종류에 따라 달라집니다. widget_keys 없이 scope만 한 번 보내 available_widget_keys를 조회한 다음, 필요한 위젯만 요청하십시오.
전체 액세스 API 키만 이 엔드포인트를 호출할 수 있습니다. 범위가 제한된 키는 보유한 액세스 권한과 관계없이 403을 받으며, 다른 애플리케이션의 키도 마찬가지입니다. API 키를 참조하십시오.

관련 항목

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

organization_id
string<uuid>
필수

조직 UUID입니다.

application_id
string<uuid>
필수

애플리케이션 UUID입니다. API 키가 속한 애플리케이션이어야 합니다. 다른 애플리케이션에 사용된 키는 403을 받습니다.

쿼리 매개변수

start_date
string<date>

조회 기간의 시작일(UTC)로, YYYY-MM-DD 형식(포함)입니다. end_date와 함께 전송해야 합니다. 둘 중 하나라도 누락되면 둘 다 무시되고 오늘 기준 30일 전부터 오늘까지로 조회 기간이 설정됩니다.

예시:

"2026-10-01"

end_date
string<date>

범위의 마지막 날(YYYY-MM-DD, 해당 일자 포함, UTC)입니다. 미래 날짜는 오늘로 간주됩니다. 범위는 730일을 초과할 수 없습니다.

예시:

"2026-10-15"

scope
enum<string>

위젯을 반환할 대시보드 탭입니다(대소문자 구분 없음). KYC 요약의 경우 widget_keys와 함께 생략합니다. widget_keys만 전송하면 kyc로 간주됩니다. home은 모든 KYC, KYB 또는 거래 위젯을 허용하며 애플리케이션에 저장된 홈 레이아웃을 기본값으로 사용합니다.

사용 가능한 옵션:
home,
kyc,
kyb,
transactions
widget_keys
string

쉼표로 구분된 위젯 키 목록으로, 이 순서대로 반환됩니다. 스코프에서 허용하지 않는 키는 제외되며, 유효한 키가 남지 않으면 해당 스코프의 기본값이 제공됩니다. KYC: kyc_sessions_volume, kyc_warning_insights, kyc_id_locations, kyc_ip_locations, kyc_workflow_funnel, kyc_average_verification_time, kyc_conversion_rate, kyc_conversion_by_country, kyc_resubmission_insights, kyc_original_status_distribution, kyc_database_validation_coverage, kyc_database_validation_latency, kyc_demographics, kyc_device_details. KYB: kyb_sessions_volume, kyb_workflow_funnel, kyb_average_verification_time, kyb_ip_locations, kyb_business_country_distribution, kyb_warning_insights, kyb_conversion_rate, kyb_conversion_by_country, kyb_industry_breakdown, kyb_resubmission_insights, kyb_original_status_distribution, kyb_registry_coverage, kyb_registry_data_completeness, kyb_device_details. Transactions: tx_count_total, tx_count_daily, tx_volume_total_preferred_currency, tx_volume_daily_preferred_currency, tx_average_amount, tx_average_amount_daily, tx_transaction_category_breakdown, tx_action_type_breakdown, tx_status_volume_trend, tx_user_ip_or_country_distribution, tx_tag_breakdown, tx_top_rules_triggered, tx_team_member_performance, tx_score_histogram.

예시:

"tx_count_total,tx_count_daily"

workflow_ids
string

쉼표로 구분된 워크플로 ID 목록입니다. KYC 요약 및 KYC, KYB 위젯을 해당 워크플로로 제한합니다. UUID가 아닌 값은 무시되며, 유효한 값이 없으면 필터가 적용되지 않습니다. 요약에서는 workflow_id도 사용할 수 있습니다.

예시:

"33333333-4444-5555-6666-777777777777"

versions
string

쉼표로 구분된 워크플로 버전 번호 목록입니다. workflow_ids와 함께 사용할 때만 적용되며, 정수가 아닌 값은 무시됩니다. 별칭으로 version도 사용할 수 있습니다.

예시:

"3,4"

branch_path_ids
string

쉼표로 구분된 분기 경로 ID. workflow_ids와 함께 사용할 때만 적용되며 KYC 수치에만 해당합니다. 현재 수치는 default(모든 경로 합산)에 대해서만 기록되므로 다른 값을 지정하면 빈 수치가 반환됩니다. branch_path_id는 별칭으로 허용됩니다.

예시:

"default"

tag
string

거래 위젯 전용: 쉼표로 구분된 태그 UUID 또는 태그 이름입니다.

transaction_type
string

거래 위젯 전용: 쉼표로 구분된 거래 카테고리입니다.

예시:

"finance"

action_type
string

거래 위젯 전용: 쉼표로 구분된 작업 유형(대소문자 구분 없음).

예시:

"withdrawal"

응답

scope 또는 widget_keys가 전송된 경우 KYC 요약 또는 요청된 위젯입니다.

사용자 인증(KYC) 요약으로, scope와 widget_keys가 모두 전송되지 않은 경우 반환됩니다.

data_points
object[]
필수

해당 범위 내 세션이 있는 첫날부터 end_date까지 하루당 하나의 포인트입니다. grouping_mode 설정과 관계없이 항상 일별로 제공됩니다.

request_breakdown
object
필수

해당 범위의 상태 합계입니다. 이전 기간 세부 내역에는 최소한 필수 필드가 포함됩니다.

previous_data_points
object[]
필수

start_date 직전의 동일한 길이의 기간에 대한 일별 포인트입니다.

previous_request_breakdown
object
필수

해당 범위의 상태 합계입니다. 이전 기간 세부 내역에는 최소한 필수 필드가 포함됩니다.

conversion_rate
number | null
필수

total_approved / (total_approved + total_declined + total_in_review) x 100, 소수점 한 자리입니다. 완료된 항목이 없으면 null입니다.

location_stats
object
필수
demographic_stats
object
필수
device_details
object
필수

세션 수가 가장 많은 순으로 각각 상위 5개입니다.

workflow_funnel_stats
object
필수

워크플로 ID별로 키가 지정됩니다. total은 해당 워크플로에서 시작된 세션 수이며, steps는 각 단계(OCR, LIVENESS, FACE_MATCH, AML, POA, PHONE, EMAIL, NFC, DATABASE_VALIDATION, QUESTIONNAIRE, IP_ANALYSIS, AGE_ESTIMATION, KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE)에 도달한 세션 수를 집계합니다. 단계에 도달한 것이 해당 단계를 통과한 것을 의미하지는 않습니다.

verification_time_stats
object
필수

유휴 시간을 제외하고 사용자가 인증에 소비한 실제 활동 시간입니다. 데이터가 없으면 빈 객체입니다.

resubmission_stats
object
필수
warning_stats
object
필수

기능별로 키가 지정됩니다(ID_VERIFICATION, LIVENESS, FACEMATCH, AML, PROOF_OF_ADDRESS, PHONE, EMAIL, NFC, LOCATION, DATABASE_VALIDATION, QUESTIONNAIRE 및 KYB 기능). total은 해당 기능에 도달한 세션 수이며, risks는 경고 코드 및 수준별 세션 수를 집계합니다.

original_status_stats
object
필수

검토자가 변경하기 전 워크플로의 자동 판정 결과입니다.

grouping_mode
enum<string>
필수

*_time_series 목록이 그룹화되는 방식입니다. 최대 14일까지는 day, 90일까지는 week, 그 이상은 month입니다. 해당 범위에서 세션이 발생한 첫날부터 측정됩니다.

사용 가능한 옵션:
day,
week,
month
demographic_time_series
object[]
필수
device_time_series
object[]
필수
verification_time_time_series
object[]
필수
resubmission_time_series
object[]
필수
original_status_time_series
object[]
필수
마지막 수정일 2026년 11월 7일