Documentation

Everything you need to integrate Crimate APIs into your application.

Quick Start

1. Create an account — Sign up free. Every product includes a free tier.
2. Generate an API key — Go to Dashboard → API Keys and create a key for the product you want to use.
3. Make your first request — Include your key in the Authorization header:

curl -H "Authorization: Bearer db_cipc_live_YOUR_KEY" \
     https://api.crimate.net/v1/cipc/stats

Authentication

All API requests require a valid API key. Pass it via the Authorization header or X-API-Key header.

Authorization: Bearer db_cipc_live_aBcDeFgH1234...

# OR

X-API-Key: db_cipc_live_aBcDeFgH1234...

API keys are scoped to a single product. A CIPC key cannot access Tax endpoints.

API Products

CIPC Company Registry

Live

South African company search, verification, director lookups, and filing history.

/v1/cipc

7 endpoints

SA Tax & Fiscal Reference

Live

SARS tax brackets, rebates, thresholds, and income tax calculation endpoints.

/v1/tax

7 endpoints

SAPS Crime Statistics

Live

Crime data by police station, category, and geographic region.

/v1/crime

5 endpoints

Global Charity Verification

Live

Nonprofit and charity verification across US, UK, and South Africa.

/v1/charity

5 endpoints

Global Food Price Index

Live

Food price indices, commodity prices, and trends across 80+ countries.

/v1/food

7 endpoints

Water Quality Data

Live

Water quality measurements, contaminant levels, and WHO compliance checks.

/v1/water

7 endpoints

African Agricultural Pricing

Live

Crop prices, market data, and seasonal trends across African markets.

/v1/agri

7 endpoints

African Livestock Pricing

Live

Livestock auction prices and market data across African markets.

/v1/livestock

7 endpoints

Global Product Recall

Live

Product safety recalls and hazard alerts from FDA, CPSC, RASFF, and NRCS.

/v1/recalls

7 endpoints

African Healthcare Facilities

Live

Hospital locations, services, capacity, and proximity search across Africa.

/v1/healthcare

7 endpoints

Global Rent & Housing Prices

Live

Rental prices, housing indices, and affordability metrics by city.

/v1/housing

7 endpoints

Drug Interaction Database

Live

Drug interactions, side effects, and contraindications.

/v1/drugs

7 endpoints

Global Trade Tariff

Live

HS codes, tariff rates, trade agreements, and duty calculations.

/v1/tariff

7 endpoints

Academic Curriculum

Live

Curriculum standards, learning outcomes, and subject structures.

/v1/curriculum

7 endpoints

SA Property & Deeds Registry

Live

Property records, ownership history, valuations, and transfers.

/v1/property

7 endpoints

Construction Material Pricing

Live

Building material prices, indices, and regional comparisons.

/v1/construction

7 endpoints

SA Public Transport

Live

Routes, stops, schedules, and fares for South African public transport.

/v1/transport

7 endpoints

Pan-African Regulatory

Live

Regulations, compliance requirements, and policy data across Africa.

/v1/regulatory

7 endpoints

Immigration & Visa Requirements

Live

Visa requirements, processing times, and policy updates.

/v1/visa

7 endpoints

Spaza Shop Registry

Live

Spaza shop registrations, inspections, and compliance data.

/v1/spaza

7 endpoints

Unified Utility Outage

Live

Power outages, loadshedding schedules, and water interruptions.

/v1/utility

7 endpoints

Professional License Verification

Live

License verification across medical, legal, engineering, and more.

/v1/license

7 endpoints

Error Codes

HTTP Status	Error Code	Meaning
401	unauthorized	Missing or invalid API key
403	product_mismatch	API key is for a different product
403	subscription_inactive	Subscription expired or cancelled
404	not_found	Resource does not exist
429	rate_limit_exceeded	Too many requests per minute
429	quota_exceeded	Daily or monthly quota exceeded
500	internal_error	Server error (contact support)