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

Name	In	Type	Required	Example
`number`	query	string	Yes	`0244123456`

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

Name	In	Type	Required	Example
`code`	path	string	Yes	`040`

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

Name	In	Type	Required	Example
`year`	path	integer	Yes	`2026`

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"
    }
  ]
}

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.