Anonymised figures from officer training.

For researchers and lenders. Each figure will be an anonymised total drawn from training: officers' competency, their readiness and how far the training has reached. None of it is live credit-market data, and each response will state how privacy was protected, so you can cite it.

Request access See the request format

Access levels

Access is agreed with each institution.

Research

Universities, think tanks, journalists

Quota: A monthly query limit
Granularity: Weekly and monthly

Totals only, with no record about any one person
Cite us when you publish

Institutions

Lenders and other financial institutions

Quota: More queries each month
Granularity: Daily, weekly, monthly

Every metric the API publishes
Every region the API covers
A higher limit on queries per minute
We set it up with you

Supervisors

Public bodies that supervise lenders

Quota: No query limit
Granularity: Daily, weekly, monthly

The longest history the API holds
Direct contact with us

Reference

The query endpoint

POST to /api/insights/v1/query, authenticated with a bearer key. The body names a metric, a period and a granularity.

curl -X POST https://litfin-training.com/api/insights/v1/query \
  -H "Authorization: Bearer lfn_insight_..." \
  -H "Content-Type: application/json" \
  -d '{
    "metric": "credit_demand_index",
    "region": { "country": "TZ" },
    "dateRange": { "from": "<YYYY-MM-DD>", "to": "<YYYY-MM-DD>" },
    "granularity": "monthly"
  }'

{
  "success": true,
  "data": {
    "series": [
      { "t": "<YYYY-MM-DD>", "value": <number>, "unit": "<unit>",
        "ci95Low": <number|null>, "ci95High": <number|null> }
    ],
    "metadata": {
      "privacyLevel": "<public|k-anonymous|dp-noised>",
      "kAnonymity": <number|null>,
      "epsilonDP": <number|null>,
      "sourceCount": <number>,
      "suppressedBuckets": <number|null>
    },
    "generatedAt": "<ISO-8601>"
  }
}

Request fields

metric: One of the identifiers listed alongside.
dateRange: The period to report on: from and to, as YYYY-MM-DD dates.
granularity: daily, weekly or monthly.
regionoptional: A two-letter country code, with an optional first-level region.
segmentoptional: Narrows the series by industry, borrower type, loan product or the gender of the primary borrower.

Metrics

The endpoint accepts these identifiers and refuses any other.

credit_demand_index
approval_rate
default_rate
portfolio_yield
npl_ratio
avg_ticket_size
disbursement_volume
vicoba_participation_rate
female_borrower_share
msme_new_origination

Privacy

Each response can be cited.

privacyLevel. One of public, k-anonymous or dp-noised.
kAnonymity. The smallest group size allowed before any figure is released.
epsilonDP. The differential privacy budget spent on this query, when DP noise is applied.
sourceCount. How many independent sources the total was built from.

Ask us for access

Tell us what your organisation does, what the figures are for and which metrics you need. We reply within two business days.

Email insights@litfin-training.com