For developers

API & Integrations

Two ways to integrate live AISL data into your own site, app or system: an embeddable visual image, and a structured JSON API for programmatic use. Both public, no auth key required, cached for 1 hour.

AISL Score Badge (SVG image)

An image generated on the fly showing the score, category and market name — usable like any image (<img>, Markdown, deck, email). Updates automatically with every score revision, nothing to do on your end.

Endpoint

GET /api/badge/{ISO3}.svg

Example

https://aisl-web-mvp.vercel.app/api/badge/NGA.svg

Replace NGA with any ISO 3166-1 alpha-3 country code (e.g. KEN, ZAF, MAR). Every country profile offers a ready-to-use copy button (HTML and Markdown).

Public JSON API

The developer counterpart of the badge: the same data, structured, for programmatic integration into your own system (internal scoring, dashboard, data pipeline).

Endpoint

GET /api/public/score/{ISO3}.json

Example

https://aisl-web-mvp.vercel.app/api/public/score/NGA.json

Typical response

{
  "iso3": "NGA",
  "name": "Nigeria",
  "region": "West Africa",
  "score": {
    "adjusted": 61.2,
    "base": 68.0,
    "category": "Open / Low Friction",
    "lowConfidence": false,
    "lastUpdated": "2026-08-15T10:32:00Z"
  },
  "market": {
    "year": 2024,
    "premiumsUsd": 2100000000,
    "penetrationPct": 0.004,
    "growthPct": 0.08,
    "densityUsd": 9.4
  },
  "regulatoryFriction": {
    "compulsoryCession": false,
    "cessionBeneficiary": null,
    "rightOfFirstRefusal": false,
    "localCapacityRequirement": false,
    "ratingMinimumRequirement": false,
    "accreditationRequirement": false,
    "withholdingTax": true,
    "frontingSpecialAcceptance": false
  },
  "links": {
    "profile": "https://aisl-web-mvp.vercel.app/countries/nigeria/",
    "badge": "https://aisl-web-mvp.vercel.app/api/badge/NGA.svg"
  },
  "disclaimer": "AISL data is a decision-support tool, not legal, actuarial, regulatory or investment advice.",
  "source": "AISL — Africa Insurance Signal Lab (africainsurancesignallab.com)"
}

Best practices

Caching

Both endpoints are cached for 1 hour (CDN and browser). No need to implement your own cache for standard use.

CORS

Both endpoints accept cross-origin requests, usable directly from a browser on another domain.

ISO codes

Always use ISO 3166-1 alpha-3 codes (3 letters, e.g. NGA, KEN, ZAF). An unknown code returns an explicit 404 error.

Attribution

The source field of the JSON response identifies AISL as the source — keep this attribution if you reuse the data publicly.

Need more?

These two public endpoints cover per-market individual use. For broader access (bulk export, deeper integration, extended API access), contact the AISL team via the Contact.

Data exposed by these endpoints is a decision-support tool, not legal, actuarial, regulatory or investment advice. It reflects the state of AISL data at the time of the request and may change.