> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 기업 KYB 이력: 세션 및 보고서

> Didit 기업 엔티티에 연결된 모든 KYB 세션을 조회하고, 법인 등기 데이터와 AML 히트를 확인하며, 재인증을 트리거하고 컴플라이언스 보고서를 생성하세요.



KYB 이력 프롬프트
        프롬프트를 클립보드에 복사



      
      

\<pre>

\````# Goal — read a business's full KYB history and trigger re-verification

Every KYB session is linked to the Business entity via `vendor_data`. List sessions, retrieve each decision, and create new sessions for re-KYB.

\## List every KYB session for a business

\```bash
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=biz-acme" \
\--data-urlencode "page_size=50"
\```

KYB session payloads carry `session_kind: "business"` and `business_session_id` to distinguish them from KYC sessions.

\## Inspect a single KYB decision

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

KYB decisions include:

\- Company registry data (legal name, registration, status, incorporation date, addresses)
\- `key_people_checks[]` — UBOs, shareholders, directors, officers (registry-sourced and user-submitted, with role tags)
\- `aml_screenings[]` — company AML and per-person AML
\- `document_verifications[]` — uploaded docs with OCR extracts and signed image URLs

See /business-verification/response-schema for the full payload.

\## Fast path — fully verified right now?

\```bash
curl https://verification.didit.me/v3/businesses/biz-acme/ \
-H "x-api-key: $DIDIT_API_KEY"
\# data.features = { KYB: "Approved" }
\```

The Business entity's `features` map holds the latest company verification status under the `KYB` key.

\## Trigger re-KYB

Annual re-KYB or trigger-based re-checks: create a new session against the same `vendor_data`. The new session attaches to the existing Business entity.

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "wf_kyb_annual", "vendor_data": "biz-acme"}'
\```

\## Generate a KYB PDF report

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o kyb-report.pdf
\```

PDF covers registry data, ownership structure, AML hits, document images, per-officer KYC status, questionnaires, phone verification, email verification, and IP analysis when those features are part of the workflow.

\## Resubmit vs new session

\| Scenario | Use |
\|---|---|
\| Registry needs corrected company name | Resubmit — analyst edits data and re-runs registry |
\| Additional document requested | Resubmit — business uploads the missing document |
\| Annual / trigger-based re-KYB | Create a brand new session |

\`kyb_key_people` and `kyb_registry` cannot be resubmitted directly — to re-verify a person, resubmit their child KYC session; the parent Key People feature re-aggregates automatically.

\## Share a session

\```bash
curl -X POST https://verification.didit.me/v3/session/$SESSION_ID/share/ \
-H "x-api-key: $DIDIT_API_KEY"

curl -X POST https://verification.didit.me/v3/session/import-shared/ \
-H "x-api-key: $RECEIVER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"share_token": "..."}'
\```

\## Failure modes

\- `404` — wrong `vendor_data` casing or no KYB sessions yet.
\- Stale signed image URLs — re-fetch the decision.
\- `session_kind: "user"` events in the same list — filter on `session_kind === "business"` for KYB-only handling.

\## Sources of truth

\- /business-verification/response-schema — full KYB decision payload
\- /business-verification/statuses — feature state machine
\- /entities/businesses/data-model — features map computation
\- /core-technology/reusable-kyc/overview — share / import pattern
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

붙여넣을 곳

기업 엔티티에 연결된 모든 기업 확인(KYB) 세션은 영구적으로 연결되어 있습니다. 전체 이력을 조회하고, 각 세션의 등록 정보와 AML 히트를 확인하고, 재인증을 트리거하고, 감사용 PDF 보고서를 생성할 수 있습니다.## 기업의 모든 기업 확인(KYB) 세션 조회세션 목록을 `vendor_data`로 필터링하세요:```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"
```응답에는 상태와 관계없이 모든 기업 확인(KYB) 세션이 포함됩니다.## KYB 기능 이해하기KYB 세션에서는 다음 기능이 실행되며, 각 기능은 세션 결정에서 고유한 상태를 가집니다:| 기능 | 다루는 내용 |
| - | - |
| `KYB_REGISTRY` | 법인 등기부 조회 - 존재 여부, 상태, 신원 교차 확인 |
| `AML` | 기업 단위 AML 스크리닝(제재, 부정적 언론 보도, 감시 목록) |
| `KYB_DOCUMENTS` | 문서 수집 및 OCR 교차 대조 |
| `KYB_KEY_PEOPLE` | 임원, UBO, 실소유자 식별 및 선택적 KYC |기업 엔티티의 `features` 맵에는 최신 기업 인증 상태만 저장됩니다:```json theme={null}
"features": {
  "KYB": "Approved"
}
```전체 참조는 [KYB 기능 상태](https://docs.didit.me/ko/business-verification/statuses.md)를 확인하세요.## 단일 기업 확인(KYB) 세션 확인하기```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```KYB 결정에는 다음 항목이 포함됩니다:- 법인 등기부 데이터(법적 명칭, 등록 정보, 상태, 설립일, 주소)
- 등기부에서 추출한 임원 및 UBO
- 소유 구조(지분표, 실소유 지분 비율)
- 기업 AML 결과(히트, 점수)
- UBO와 임원 각각에 대한 개인 AML
- OCR 추출 내용이 포함된 문서 결과
- 결정 사유 코드전체 페이로드는 [KYB 응답 스키마](https://docs.didit.me/ko/business-verification/response-schema.md)를 참조하세요.## 재인증 트리거하기연간 재-KYB, 트리거 기반 재확인, 또는 보완 절차는 모두 새 세션으로 시작합니다:```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'
```새 세션은 기존 기업 엔티티에 연결되며, 완료되면 `features` 맵을 업데이트합니다.## 재제출과 새 기업 확인(KYB) 세션 비교| 상황 | 사용 방법 |
| - | - |
| 등기부 조회에 수정된 기업명이 필요함 | 재제출 - 분석가가 데이터를 수정하고 등기부 조회를 다시 실행 |
| 기업에 추가 문서가 요청됨 | 재제출 - 기업이 누락된 문서를 업로드 |
| 연간 또는 트리거 기반 재-KYB | 새 세션 생성 |## KYB 보고서 내보내기모든 기업 확인(KYB) 세션에 대해 종합 PDF를 생성하세요:```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf
```PDF에는 등기부 데이터, 소유 구조, AML 히트, 문서 이미지, 임원 KYC 상태, 결정 사유가 담긴 표지가 포함됩니다.## 기업 확인(KYB) 세션 공유하기컨소시엄 또는 파트너 워크플로의 경우:- `POST /v3/session/{session_id}/share/` - 공유 가능한 token을 생성합니다.
- `POST /v3/session/import-shared/` - 수신 측에서 가져옵니다.## 지속적인 모니터링지속적인 모니터링 모드의 기업 엔티티에는 주기적인 AML 재스캔이 적용됩니다. 새로운 제재 또는 부정적 언론 보도 히트가 감지되면 기업 AML 스크리닝이 업데이트되며, 이는 세션 결정의 `aml_screenings[]`에서 확인할 수 있습니다.콘솔의 *Workflows → \[KYB workflow] → AML → Ongoing monitoring*에서 지속적인 모니터링을 설정하세요.## 다음 단계> [card] [KYB 개요](https://docs.didit.me/ko/business-verification/overview.md)
>
> 기업 확인(KYB) 세션이 처음부터 끝까지 어떻게 작동하는지 알아보세요.> [card] [KYB 응답](https://docs.didit.me/ko/business-verification/response-schema.md)
>
> 전체 결정 페이로드를 참조하세요.> [card] [주요 인물](https://docs.didit.me/ko/entities/businesses/key-people.md)
>
> 임원, UBO, 연결된 사용자.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.