Skip to main content
Officers, directors, and representatives are not a separate concept in Didit’s KYB model — they live inside Key People alongside UBOs and shareholders, tagged with one or more roles per person. A single person can be a director and a shareholder, or a representative and an authorized signatory — the party carries the full role list, not just one role.

​
Full role taxonomy

Every key person can hold one or more of these roles:

​
Governance / representation

RoleDescription
directorBoard member with governance responsibilities
non_executive_directorBoard member without day-to-day management duties
chairmanChair of the board
secretaryCompany secretary handling administrative and compliance duties
representativeLegal or appointed representative of the company
authorized_signatoryPerson empowered to sign on behalf of the company
trusteeTrustee of a structure holding company interests
company_officerGeneral officer role
founderFounding member of the company
legal_advisorRetained legal counsel for the company
otherAny role outside the standard taxonomy

​
Ownership / beneficiary

RoleDescription
uboUltimate Beneficial Owner — individual who ultimately owns or controls the company
shareholderRegistered shareholder (individual or corporate)
beneficiaryBeneficiary of a trust or similar structure
settlorSettlor of a trust
protectorProtector of a trust
investorInvestor role (outside formal share ownership structures)
A single person can carry both categories — for example, a founder who is also a director and a UBO holds three roles on the same key-people record.

​
Multi-role records

Each key person record includes a list of roles, each with its own ownership/voting percentages where relevant. This is how a director-plus-shareholder looks in the response: 
{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "Jane",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}

​
KYC linking

Every key person can be linked to an individual User Verification (KYC) session. The linking happens automatically when the role’s workflow settings require KYC — the system spawns the child KYC session, emails the person their verification link (if that option is enabled), and tracks status back on the party. See Ownership → How role settings drive verification for the full routing logic. For the B2C-safe KYC status values surfaced on each party (Approved, Declined, Pending), see the response schema.

​
AML screening

Every identified key person is automatically screened against global AML watchlists as part of the business verification process. PEP matches are especially relevant for governance roles — directors and signatories of regulated companies often surface on PEP lists. See Business AML screening.

​
Requires-verification flag

Each party carries a requires_verification flag that tells you whether the workflow demands KYC for that person:
ValueMeaning
trueKYC must complete for this person before the session can approve.
falsePerson is identified and AML-screened but does not need individual KYC.
Configure which roles require verification from Workflows → [KYB workflow] → Key People → per-role settings. Typical defaults:
  • Directors and UBOs above the workflow’s threshold → requires_verification: true.
  • Authorized signatories and secretaries → optional.
  • Non-executive board members → optional.

​
Skipping a key person

If a person cannot be verified (deceased, unreachable, historical), they can be marked with is_skipped: true — either by the end user in the hosted flow (if the role’s settings allow skipping) or by an analyst from the console. Skipped parties are excluded from the verification gate but still surface in the response for audit.

​
Cross-referencing across sources

Data about each key person can come from three places, and the console shows all three side-by-side:
  • Registry records — what the official registry disclosed.
  • User-submitted — what the business admin confirmed or added in the Key People flow.
  • Uploaded documents — names extracted via OCR from articles of association, shareholder registers, or power-of-attorney documents.
Inconsistencies surface as warnings on the session decision.

​
Effect on the Business entity

Linking a key person to a User entity via KYC creates a lasting relationship on the Business entity. You can then:
  • See every business each person serves in a governance or ownership role.
  • Propagate a User’s status changes (flagged, blocked) into businesses where they serve as a key person.
  • Run ongoing AML monitoring on each linked person independent of any specific KYB session.

​
Next steps

Key people

The full Key People flow.

Ownership

UBO identification and ownership chains.

AML

Company and person AML screening.