Documentation

Build on Ghana’s reference data.

Base URL: https://ghanaapi.sintim-koree.com/api. All responses are JSON. Errors use { error: { code, message, status } }.

View the OpenAPI 3.1 specification

Endpoint

Phone validation

GET /v1/phone/validate

Normalize and validate Ghanaian phone number structure. Returns E.164 plus carrier and MoMo indicators inferred from the prefix; it does not confirm active service, wallets, ported carriers, or transfer capability.

Parameters

NameInTypeRequiredExample
numberquerystringYes0244123456
Request
curl "https://ghanaapi.sintim-koree.com/api/v1/phone/validate?number=0244123456"
Example response
{
  "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."
}

Endpoint

Banks (list)

GET /v1/banks

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

Request
curl "https://ghanaapi.sintim-koree.com/api/v1/banks"
Example response
{
  "count": 23,
  "banks": [
    {
      "name": "GCB Bank",
      "bankCode": "040",
      "swift": "GHCBGHAC",
      "type": "commercial"
    }
  ]
}

Endpoint

Bank lookup

GET /v1/banks/{code}

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

Parameters

NameInTypeRequiredExample
codepathstringYes040
Request
curl "https://ghanaapi.sintim-koree.com/api/v1/banks/040"
Example response
{
  "name": "GCB Bank",
  "bankCode": "040",
  "swift": "GHCBGHAC",
  "type": "commercial"
}

Endpoint

Public holidays

GET /v1/holidays/{year}

Ghana public holidays for a given year (2024-2028). tentative: true marks dates still awaiting official confirmation; confirmed holidays are not tentative. Observed entries use their observed date and may link to the statutory date with observedFor.

Parameters

NameInTypeRequiredExample
yearpathintegerYes2026
Request
curl "https://ghanaapi.sintim-koree.com/api/v1/holidays/2026"
Example response
{
  "year": 2026,
  "holidays": [
    {
      "date": "2026-03-06",
      "name": "Independence Day",
      "type": "public",
      "tentative": false
    }
  ]
}

Endpoint

Regions

GET /v1/regions

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

Request
curl "https://ghanaapi.sintim-koree.com/api/v1/regions"
Example response
{
  "count": 16,
  "regions": [
    {
      "name": "Greater Accra",
      "capital": "Accra",
      "code": "AA"
    }
  ]
}

Endpoint

Bulk number check

POST Paid plan /v1/phone/validate/bulk

Check number formats in one request. Carrier and wallet indicators are prefix-derived; they do not confirm an active number, wallet, or ported carrier. Each number costs one quota unit. Maximum per request: 100 numbers on a direct Starter key and 1,000 on Pro; 10 on the RapidAPI Pro plan and 100 on Ultra, Mega or Custom.

Parameters

NameInTypeRequiredExample
numbersbodystring[]Yes["0244123456"]
Request
curl -X POST 'https://ghanaapi.sintim-koree.com/api/v1/phone/validate/bulk' \
-H 'Authorization: Bearer gha_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"numbers":["0244123456","12345"]}'
Example response
{
  "count": 2,
  "summary": {
    "valid": 1,
    "invalid": 1,
    "byCarrier": {
      "MTN": 1
    },
    "momoCapable": 1
  },
  "results": [
    {
      "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."
    },
    {
      "input": "12345",
      "valid": false,
      "e164": null,
      "local": null,
      "carrier": null,
      "momoCapable": false,
      "type": null,
      "portabilityNote": "Carrier derived from prefix; numbers ported between networks may differ."
    }
  ],
  "portabilityNote": "Carrier derived from prefix; numbers ported between networks may differ."
}

Endpoint

Business day check

GET /v1/business-days/check

Check whether a date is Monday-Friday and not in data/holidays.json (2024-2028). Tentative holidays are treated as holidays; calculators list those used in tentativeHolidaysUsed.

Parameters

NameInTypeRequiredExample
datequerystringYes2026-01-07
Request
curl "https://ghanaapi.sintim-koree.com/api/v1/business-days/check?date=2026-01-07"
Example response
{
  "date": "2026-01-07",
  "isBusinessDay": false,
  "reason": "holiday",
  "holiday": "Constitution Day",
  "nextBusinessDay": "2026-01-08"
}

Endpoint

Add business days

GET Paid plan /v1/business-days/add

Add business days using Monday-Friday dates not in data/holidays.json (2024-2028). Tentative holidays count as holidays and appear in tentativeHolidaysUsed.

Parameters

NameInTypeRequiredExample
fromquerystringYes2026-01-06
daysqueryintegerYes2
Request
curl -H "Authorization: Bearer gha_YOUR_KEY" "https://ghanaapi.sintim-koree.com/api/v1/business-days/add?from=2026-01-06&days=2"
Example response
{
  "from": "2026-01-06",
  "days": 2,
  "result": "2026-01-12",
  "skipped": [
    {
      "date": "2026-01-07",
      "reason": "holiday",
      "name": "Constitution Day"
    },
    {
      "date": "2026-01-09",
      "reason": "holiday",
      "name": "Constitution Day (observed)"
    },
    {
      "date": "2026-01-10",
      "reason": "weekend"
    },
    {
      "date": "2026-01-11",
      "reason": "weekend"
    }
  ],
  "tentativeHolidaysUsed": []
}

Endpoint

Business days between

GET Paid plan /v1/business-days/between

Count Monday-Friday dates not in data/holidays.json (2024-2028) over [from, to). Tentative holidays count as holidays and appear in tentativeHolidaysUsed.

Parameters

NameInTypeRequiredExample
fromquerystringYes2026-06-29
toquerystringYes2026-07-06
Request
curl -H "Authorization: Bearer gha_YOUR_KEY" "https://ghanaapi.sintim-koree.com/api/v1/business-days/between?from=2026-06-29&to=2026-07-06"
Example response
{
  "from": "2026-06-29",
  "to": "2026-07-06",
  "businessDays": 3,
  "weekendDays": 2,
  "holidays": [
    {
      "date": "2026-07-01",
      "name": "Republic Day (statutory)",
      "tentative": false
    },
    {
      "date": "2026-07-03",
      "name": "Republic Day",
      "tentative": false
    }
  ],
  "tentativeHolidaysUsed": []
}

Access

Authentication & limits

Anonymous use is free (~100 requests/day per IP). For higher limits, subscribe on RapidAPI . Direct card billing may be available on the pricing page when configured; the exact GHS price is shown at Paystack before payment. Use your Authorization: Bearer gha_… key. Keys are stored as hashes; quotas are per calendar month. For key rotation, reply to your key email.

Paid endpoints return 402 for anonymous callers and RapidAPI Basic. On direct keys the bulk number check costs one quota unit per number (RapidAPI callers use one RapidAPI request per call, with caps of 10 numbers on Pro and 100 on Ultra, Mega or Custom); a 429 response consumes nothing when quota is short.

With the proxy secret, X-RapidAPI-Subscription maps Pro to Starter caps and Ultra, Mega, or Custom to Pro caps. This header is trusted only when the proxy secret is valid. Key-authenticated paid calls require Redis and return 503 AUTH_UNAVAILABLE if authorization is unavailable.

  • Free: $0
  • Starter: $7/mo (Named “Pro” on RapidAPI)
  • Pro: $25/mo (Named “Ultra” on RapidAPI)

Compare plans on RapidAPI