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/json

Path parameters

ParameterTypeRequiredDescription
tokenstringYesInvestor share token from Klarify FundRaise Mode

Headers

HeaderRequiredDescription
AcceptRecommendedapplication/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

FieldTypeDescription
successbooleanAlways true on 200
dataobjectCompliance status snapshot
meta.token_statusstring"active" when token is valid
meta.view_countintegerTotal views (human + API), incremented on each successful call

data — snapshot

FieldTypeDescription
api_versionstringSchema version (2026-06-18)
company.namestringOrganisation name
scores.readiness_scoreintegerLive ComplianceOS Readiness Score (0–100)
scores.readiness_labelstringCritical · In Progress · Good Standing · Regulator Ready
scores.fundraise_scoreintegerFundRaise composite score (0–100)
scores.fundraise_risk_bandstringhigh · medium · low · investor_ready
scores.fundraise_risk_labelstringHuman-readable risk summary
scores.checklist_completion_pctintegerDD checklist completion percentage
scores.checklist_completeintegerCompleted checklist items
scores.checklist_totalintegerTotal checklist items
licensing.product_classificationstring | nulle.g. DAX, DAOP, PAYMENT
licensing.product_classification_labelstring | nullFull category name
licensing.primary_regulatorstring | nulle.g. SEC_NIGERIA, CBN
licensing.secondary_regulatorsstring[]Additional regulators
licensing.arip_stagestring | nullARIP stage code
licensing.arip_stage_labelstring | nullHuman-readable ARIP stage
verification.last_score_calculated_atISO 8601When Readiness Score was last calculated
verification.pack_generated_atISO 8601 | nullWhen linked DD pack was generated
verification.pack_verification_hashstring | nullShort hash for pack integrity reference
verification.share_expires_atISO 8601When this token expires
verification.snapshot_atISO 8601When this response was generated
top_gapsarrayUp to 3 highest-priority regulatory gaps
top_gaps[].titlestringGap title
top_gaps[].severitystringcritical · high · medium
top_gaps[].regulatory_basisstringPlain-English regulatory context
links.human_summary_urlstringBrowser-readable investor DD view
links.klarify_profile_urlstringKlarify marketing site
disclaimerstringRequired — display in your UI

Readiness score labels

Score rangeLabel
0–40Critical
41–70In Progress
71–90Good Standing
91–100Regulator Ready

FundRaise risk bands

BandTypical meaning
highSignificant regulatory gaps — high investment risk
mediumMaterial gaps remain — proceed with enhanced DD
lowMinor gaps — generally investable from regulatory perspective
investor_readyStrong posture for stated product type

ARIP stage codes

CodeLabel
initial_assessmentStage 1: Initial Assessment
eligibility_notificationStage 2: Eligibility Notification
formal_applicationStage 3: Formal Application
aip_activeStage 4: AIP — Active
transition_to_registrationStage 5: Transition to Registration

Product classification codes

CodeLabel
DAXDigital Asset Exchange
DAOPDigital Asset Offering Platform
DACDigital Asset Custodian
DAIDigital Asset Intermediary
AVASPAncillary VASP
DAPODigital Assets Platform Operator
RATOPReal-world Assets Tokenization Platform
PAYMENTPayment product
HYBRIDHybrid (multiple categories)

Errors

See Errors & rate limits for full codes. Common cases:

HTTPCodeMeaning
404NOT_FOUNDToken invalid or revoked
410EXPIREDToken past expiry date
429RATE_LIMITEDMore 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.