API documentation

Public data API

ACDC exposes its public, published-data endpoints over tRPC at /api/trpc. Anything not listed here requires an authenticated, role-scoped session — see the Data policy page for what is public versus restricted.

Example request

curl "https://acdc.unafri.org/api/trpc/countries.list?input=%7B%22tenantId%22%3A%22<tenant-id>%22%7D"

Or from a Node/browser client using @trpc/client with superjson as the transformer.

querycountries.list

Every Member State with aggregated, published-only stats (case count, average data quality).

input: { tenantId: string }

queryoverview.getContinentalStats

Headline continental numbers — reporting countries, total case records, average data quality.

input: { tenantId: string }

queryoverview.getCourtOutcomeBreakdown

Court outcomes as a percentage breakdown, continental or scoped to one country.

input: { countryId?: string }

queryoverview.getIccsCategoryVolume

Case volume grouped by ICCS classification.

input: { countryId?: string, limit?: number }

querycrimeRecords.list

Published crime records, cursor-paginated, filterable by country and ICCS category.

input: { countryId?: string, iccsCategoryId?: string, limit?: number, cursor?: {...} }

queryreports.list

Published research reports — monthly/quarterly/annual, country profiles, policy briefs.

input: { countryId?: string, type?: string }

Requesting an API key for automated, higher-rate-limit access? Reach out via the Contact page — apiKeys issuance is not self-service yet.