Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt

Use this file to discover all available pages before exploring further.

Shareholder verification raises the bar from “this company exists” to “we know who is behind it.” Each director or shareholder is checked against a government-issued ID, and the resulting share split is reconciled against CAC’s filed ownership.

​
What gets verified per person

FieldSource
Full nameCAC + government ID match
Date of birthGovernment ID
NationalityGovernment ID
ID numberManually entered; cross-checked against the uploaded document
Role and ownership percentageOwner-declared, reconciled against CAC’s filed share register
Accepted ID types: NIN, International Passport, Driver’s Licence, Voter’s Card.

​
How it runs

The owner adds each shareholder from the dashboard with their personal details and uploads a PDF of the ID. The backend stores the document, OCRs it, and confirms the printed name/number against the entered fields. The score’s Shareholder Verified bucket (60 points) clears only when every director or material shareholder (≥ 5% ownership) has been verified.

​
Endpoints

curl -X POST https://api.vouchmark.com/v1/company/cmp_aBcD.../shareholder \
  -H "Authorization: Bearer $TOKEN" \
  -F "name=Jane Doe" \
  -F "email=jane@example.com" \
  -F "address=14 Marina Road" \
  -F "dateOfBirth=1984-02-12" \
  -F "nationality=Nigerian" \
  -F "idType=NIN" \
  -F "identificationNumber=12345678901" \
  -F "roleInCompany=Director" \
  -F "percentageOfOwner=40" \
  -F "noOfShares=4000" \
  -F "identificationDocument=@./jane-nin.pdf"

​
Field rules

  • percentageOfOwner is a number 0–100, accurate to one decimal.
  • The sum across all shareholders must equal 100 before the bucket can clear.
  • noOfShares is reconciled with the company’s dividedInto — total shares declared must add up.
  • Shareholders with percentageOfOwner === 0 are treated as directors only and never count toward the score.

​
Privacy

ID documents are stored encrypted at rest. The document URL is signed and time-limited, and is only ever served to authenticated callers who own the company record. We do not share ID data with third parties.