API Documentation

Base URL: /api · All responses are JSON · Errors use a { error: { code, message, status } } envelope · OpenAPI 3.1 spec

Phone validation

GET /api/v1/phone/validate?number=0244123456

Normalize and validate any Ghanaian phone number format. Returns E.164, carrier (prefix-based), and MoMo capability.

curl "https://ghanaapi.sintim-koree.com/api/v1/phone/validate?number=0244123456"

{
  "input": "0244123456",
  "valid": true,
  "e164": "+233244123456",
  "local": "0244123456",
  "carrier": "MTN",
  "momoCapable": true,
  "type": "mobile",
  "portabilityNote": "Carrier derived from prefix; numbers ported between networks may differ."
}

Banks (list)

GET /api/v1/banks

All licensed Ghanaian banks with bank codes and SWIFT/BIC.

curl "https://ghanaapi.sintim-koree.com/api/v1/banks"

{
  "count": 23,
  "banks": [
    {
      "name": "GCB Bank",
      "bankCode": "040",
      "swift": "GHCBGHAC",
      "type": "commercial"
    }
  ]
}

Bank lookup

GET /api/v1/banks/040

Look up a single bank by bank code or SWIFT/BIC.

curl "https://ghanaapi.sintim-koree.com/api/v1/banks/040"

{
  "name": "GCB Bank",
  "bankCode": "040",
  "swift": "GHCBGHAC",
  "type": "commercial"
}

Public holidays

GET /api/v1/holidays/2026

Ghana public holidays for a given year (2024-2028). Moon-dependent holidays carry tentative: true.

curl "https://ghanaapi.sintim-koree.com/api/v1/holidays/2026"

{
  "year": 2026,
  "holidays": [
    {
      "date": "2026-03-06",
      "name": "Independence Day",
      "type": "public",
      "tentative": false
    }
  ]
}

Regions

GET /api/v1/regions

The 16 regions of Ghana with capitals and ISO 3166-2 codes.

curl "https://ghanaapi.sintim-koree.com/api/v1/regions"

{
  "count": 16,
  "regions": [
    {
      "name": "Greater Accra",
      "capital": "Accra",
      "code": "AA"
    }
  ]
}

Authentication & limits

Anonymous use is free (~100 requests/day per IP). For higher limits, subscribe on RapidAPI Or subscribe directly on the pricing page (Paystack — Mobile Money or card, billed in GHS) and use your Authorization: Bearer gha_… key. Keys are stored as hashes; quotas are per calendar month. For key rotation, reply to your key email.