Seev PlusDocs
Docs
Get Paid

Check a Mobile Money Number

Find out who a mobile money number is registered to before you send money to it or save it.

Send a mobile money number and its network, and Seev returns the name the network has registered against it. Use it to show your user who they are about to pay, or to catch a mistyped number before you save it as a payout destination.

APINeeds an API key
Use it when

You are about to send money to a number, or save one as a destination, and want to show the person who it belongs to first.

Not for

Bank accounts. The lookup covers mobile money only.

Needs

An API key from the Developer Dashboard.

Look up a number

curl -X POST \
  https://api.seevplus.com/api/v1/developer/resolve-account \
  -H "Authorization: Bearer $SEEV_CHECKOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "settlement_bank": "mtn",
    "account_number": "0241234567"
  }'
{
    "success": true,
    "data": {
        "settlement_bank": "mtn",
        "account_number": "0241234567",
        "account_name": "AMA MENSAH"
    }
}

The response gives the network code and the number back in a standard form, so you can store what Seev returns rather than what your user typed.

settlement_bankReq
string

The number's network: mtn, telecel or at. Older names work too, such as vodafone for Telecel and airteltigo for AT.

account_numberReq
string

A Ghana mobile number. 0241234567, 241234567 and 233241234567 are all accepted, with or without spaces, and come back as 0241234567.

When a lookup fails

400
status

The number is not a valid Ghana mobile number, or the body is not valid JSON.

401
status

The API key is missing or not recognised.

403
status

The key is not allowed from this IP address, or the organization is suspended.

404
status

The network has no name registered for the number. Ask your user to check the number and the network.

422
status

settlement_bank is a bank code. Only mobile money numbers can be looked up.

502
status

The network could not be reached. Try again shortly.

Errors come back in the same shape as the rest of the API. See Errors.

Sandbox keys look up real numbers and return real names, the same as live keys. Test with your own number or one you have permission to use.

Show the name to your user

A registered name is personal information. Show it to the person sending the money so they can confirm it, and do not use the lookup to collect names for numbers you have no reason to pay.

The name is what the network holds, which is often in capitals and sometimes a shortened or older form of the person's name. Ask your user to confirm it is the right person rather than matching it exactly against a name they typed.

Common questions

On this page