Get compliance status
Returns a structured compliance posture snapshot for a startup that has authorised sharing via an investor share token.
API version: 2026-06-18
Request
GET /api/v1/compliance-status/{token}
Accept: application/jsonPath parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | Yes | Investor share token from Klarify FundRaise Mode |
Headers
| Header | Required | Description |
|---|---|---|
Accept | Recommended | application/json |
No Authorization header is required for v0.
Example request
curl -s "https://api.klarify.africa/api/v1/compliance-status/a1b2c3d4e5f6789012345678abcdef" \
-H "Accept: application/json"Example response
Status: 200 OK
{
"success": true,
"data": {
"api_version": "2026-06-18",
"company": {
"name": "Blockspace Technologies Ltd"
},
"scores": {
"readiness_score": 62,
"readiness_label": "In Progress",
"fundraise_score": 58,
"fundraise_risk_band": "medium",
"fundraise_risk_label": "Medium regulatory investment risk",
"checklist_completion_pct": 40,
"checklist_complete": 8,
"checklist_total": 20
},
"licensing": {
"product_classification": "DAX",
"product_classification_label": "Digital Asset Exchange",
"primary_regulator": "SEC_NIGERIA",
"secondary_regulators": ["CBN"],
"arip_stage": "formal_application",
"arip_stage_label": "Stage 3: Formal Application"
},
"verification": {
"last_score_calculated_at": "2026-06-17T12:00:00.000Z",
"pack_generated_at": "2026-06-16T09:00:00.000Z",
"pack_verification_hash": "a1b2c3d4e5f67890",
"share_expires_at": "2026-06-25T00:00:00.000Z",
"snapshot_at": "2026-06-18T09:00:00.000Z"
},
"top_gaps": [
{
"title": "AML/CFT Policy Manual",
"severity": "critical",
"regulatory_basis": "Document your AML/CFT programme per MLPPA 2022 requirements."
},
{
"title": "NFIU goAML registration",
"severity": "high",
"regulatory_basis": "Register on the NFIU goAML portal before accepting customer funds."
},
{
"title": "Product classification",
"severity": "medium",
"regulatory_basis": "Classify your product under SEC Nigeria digital asset rules."
}
],
"links": {
"human_summary_url": "https://klarify.africa/fundraise/view/a1b2c3d4e5f6789012345678abcdef",
"klarify_profile_url": "https://klarify.africa/?ref=compliance-status-api"
},
"disclaimer": "This Regulatory DD Pack is a self-assessment prepared with AI assistance based on information provided by the company. It is regulatory information, not legal advice, and does not constitute a regulatory opinion, licence, certification, or guarantee of compliance. Investors and partners should conduct their own due diligence. Verify all regulatory claims directly with qualified practitioners and relevant regulators."
},
"meta": {
"token_status": "active",
"view_count": 4
}
}Response fields
Envelope
| Field | Type | Description |
|---|---|---|
success | boolean | Always true on 200 |
data | object | Compliance status snapshot |
meta.token_status | string | "active" when token is valid |
meta.view_count | integer | Total views (human + API), incremented on each successful call |
data — snapshot
data — snapshot| Field | Type | Description |
|---|---|---|
api_version | string | Schema version (2026-06-18) |
company.name | string | Organisation name |
scores.readiness_score | integer | Live ComplianceOS Readiness Score (0–100) |
scores.readiness_label | string | Critical · In Progress · Good Standing · Regulator Ready |
scores.fundraise_score | integer | FundRaise composite score (0–100) |
scores.fundraise_risk_band | string | high · medium · low · investor_ready |
scores.fundraise_risk_label | string | Human-readable risk summary |
scores.checklist_completion_pct | integer | DD checklist completion percentage |
scores.checklist_complete | integer | Completed checklist items |
scores.checklist_total | integer | Total checklist items |
licensing.product_classification | string | null | e.g. DAX, DAOP, PAYMENT |
licensing.product_classification_label | string | null | Full category name |
licensing.primary_regulator | string | null | e.g. SEC_NIGERIA, CBN |
licensing.secondary_regulators | string[] | Additional regulators |
licensing.arip_stage | string | null | ARIP stage code |
licensing.arip_stage_label | string | null | Human-readable ARIP stage |
verification.last_score_calculated_at | ISO 8601 | When Readiness Score was last calculated |
verification.pack_generated_at | ISO 8601 | null | When linked DD pack was generated |
verification.pack_verification_hash | string | null | Short hash for pack integrity reference |
verification.share_expires_at | ISO 8601 | When this token expires |
verification.snapshot_at | ISO 8601 | When this response was generated |
top_gaps | array | Up to 3 highest-priority regulatory gaps |
top_gaps[].title | string | Gap title |
top_gaps[].severity | string | critical · high · medium |
top_gaps[].regulatory_basis | string | Plain-English regulatory context |
links.human_summary_url | string | Browser-readable investor DD view |
links.klarify_profile_url | string | Klarify marketing site |
disclaimer | string | Required — display in your UI |
Readiness score labels
| Score range | Label |
|---|---|
| 0–40 | Critical |
| 41–70 | In Progress |
| 71–90 | Good Standing |
| 91–100 | Regulator Ready |
FundRaise risk bands
| Band | Typical meaning |
|---|---|
high | Significant regulatory gaps — high investment risk |
medium | Material gaps remain — proceed with enhanced DD |
low | Minor gaps — generally investable from regulatory perspective |
investor_ready | Strong posture for stated product type |
ARIP stage codes
| Code | Label |
|---|---|
initial_assessment | Stage 1: Initial Assessment |
eligibility_notification | Stage 2: Eligibility Notification |
formal_application | Stage 3: Formal Application |
aip_active | Stage 4: AIP — Active |
transition_to_registration | Stage 5: Transition to Registration |
Product classification codes
| Code | Label |
|---|---|
DAX | Digital Asset Exchange |
DAOP | Digital Asset Offering Platform |
DAC | Digital Asset Custodian |
DAI | Digital Asset Intermediary |
AVASP | Ancillary VASP |
DAPO | Digital Assets Platform Operator |
RATOP | Real-world Assets Tokenization Platform |
PAYMENT | Payment product |
HYBRID | Hybrid (multiple categories) |
Errors
See Errors & rate limits for full codes. Common cases:
| HTTP | Code | Meaning |
|---|---|---|
| 404 | NOT_FOUND | Token invalid or revoked |
| 410 | EXPIRED | Token past expiry date |
| 429 | RATE_LIMITED | More than 60 requests/minute from your IP |
Integration tips
Screening rule example — flag applications when:
const { data } = await response.json();
const highRisk =
data.scores.readiness_score < 40 ||
data.scores.fundraise_risk_band === 'high' ||
data.top_gaps.some((g) => g.severity === 'critical');Poll sparingly — scores update when founders complete compliance tasks; daily polling is sufficient for most pipelines.
Link to human view — use data.links.human_summary_url for analysts who need the full DD pack summary in browser.

