Overview

MockAfrica is a REST API that generates realistic, country-specific fake data for African nations. It is stateless — all data is generated in-memory from weighted pools embedded at compile time. There is no database, no external calls, and no infrastructure to manage.

Use it to seed staging databases, power demos, generate test fixtures, and build realistic load tests. Every response uses the same consistent envelope - country, count, data.

Endpoints at a glance

• GET /v1/person - full person object with name, phone, email, DOB, national ID
• GET /v1/finance - bank account, mobile money, and a transaction record
• GET /v1/location - region, city, street address, and coordinates
• GET /v1/company - company name, registration number, and industry
• GET /v1/dataset - bulk export up to 50,000 rows (API key required)

Countries at launch

Five countries are supported at launch: Ghana (GH), Nigeria (NG), Kenya (KE), South Africa (ZA), and Rwanda (RW). Every endpoint accepts a country query parameter. Omit it and a country is chosen at random.