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 } }.
Endpoint
Phone validation
GET /v1/phone/validateNormalize 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
| Name | In | Type | Required | Example |
|---|---|---|---|---|
number | query | string | Yes | 0244123456 |
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."
}Endpoint
Banks (list)
GET /v1/banksAll 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"
}
]
}Endpoint
Bank lookup
GET /v1/banks/{code}Look up a single bank by bank code or SWIFT/BIC.
Parameters
| Name | In | Type | Required | Example |
|---|---|---|---|---|
code | path | string | Yes | 040 |
curl "https://ghanaapi.sintim-koree.com/api/v1/banks/040"{
"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
| Name | In | Type | Required | Example |
|---|---|---|---|---|
year | path | integer | Yes | 2026 |
curl "https://ghanaapi.sintim-koree.com/api/v1/holidays/2026"{
"year": 2026,
"holidays": [
{
"date": "2026-03-06",
"name": "Independence Day",
"type": "public",
"tentative": false
}
]
}Endpoint
Regions
GET /v1/regionsThe 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"
}
]
}Endpoint
Bulk number check
POST Paid plan /v1/phone/validate/bulkCheck 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
| Name | In | Type | Required | Example |
|---|---|---|---|---|
numbers | body | string[] | Yes | ["0244123456"] |
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"]}'{
"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/checkCheck 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
| Name | In | Type | Required | Example |
|---|---|---|---|---|
date | query | string | Yes | 2026-01-07 |
curl "https://ghanaapi.sintim-koree.com/api/v1/business-days/check?date=2026-01-07"{
"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/addAdd business days using Monday-Friday dates not in data/holidays.json (2024-2028). Tentative holidays count as holidays and appear in tentativeHolidaysUsed.
Parameters
| Name | In | Type | Required | Example |
|---|---|---|---|---|
from | query | string | Yes | 2026-01-06 |
days | query | integer | Yes | 2 |
curl -H "Authorization: Bearer gha_YOUR_KEY" "https://ghanaapi.sintim-koree.com/api/v1/business-days/add?from=2026-01-06&days=2"{
"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/betweenCount Monday-Friday dates not in data/holidays.json (2024-2028) over [from, to). Tentative holidays count as holidays and appear in tentativeHolidaysUsed.
Parameters
| Name | In | Type | Required | Example |
|---|---|---|---|---|
from | query | string | Yes | 2026-06-29 |
to | query | string | Yes | 2026-07-06 |
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"{
"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)