REST API
Onboarding metadata

Onboarding metadata

Public endpoints that return reference data for dropdowns and registration forms.


GET /meta/business-types

List available business types.

Auth: None

Response:

{
  "success": true,
  "data": [
    { "slug": "retail", "name": "Retail Shop (Duka la Rejareja)", "name_swahili": "Duka la Rejareja", "description": "Sells goods directly to final consumers" },
    { "slug": "wholesale", "name": "Wholesale (Jumla)", "name_swahili": "Duka la Jumla", "description": "Sells goods in bulk to retailers" },
    { "slug": "retail_wholesale", "name": "Retail + Wholesale", "name_swahili": "Rejareja na Jumla", "description": "Sells to walk-in customers and business buyers" },
    { "slug": "pharmacy", "name": "Pharmacy (Duka la Dawa Muhimu)", "name_swahili": "Duka la Dawa Muhimu", "description": "Sells medicines and health products" }
  ]
}

GET /meta/regions

List Tanzania regions.

Auth: None

Response:

{
  "success": true,
  "data": [
    { "slug": "arusha", "name": "Arusha", "districts": ["Arusha City", "Arusha DC", "Karatu"] },
    { "slug": "dar-es-salaam", "name": "Dar es Salaam", "districts": ["Ilala", "Kigamboni", "Kinondoni", "Temeke", "Ubungo"] }
  ]
}

GET /meta/regions/:slug/districts

List districts for a region.

Auth: None

Example: GET /meta/regions/dar-es-salaam/districts

Response:

{
  "success": true,
    "data": ["Ilala", "Kigamboni", "Kinondoni", "Temeke", "Ubungo"]
}

GET /meta/outlet-types

List pharmacy outlet types.

Auth: None

Response:

{
  "success": true,
  "data": [
    { "slug": "pharmacy", "name": "Pharmacy" },
    { "slug": "addo", "name": "ADDO" }
  ]
}