Phonenumber

fakernaija.Naija.phone_number(self, network: str | None = None, prefix: str | None = None) → str

Generate a random phone number with optional network and prefix filters.

Parameters:

  • network (str, optional) – The name of the network. Defaults to None.

  • prefix (str, optional) – The prefix of the phone number. Defaults to None.

Returns:

A valid Nigerian phone number.

Return type:

str

Raises:

ValueError – If the given prefix is not valid or the network and prefix combination does not match.

Note

Available networks and prefixes:

  • mtn: 0703, 0706, 0803, 0806, 0813, 0816, 0810, 0814, 0903, 0906, 0913, 0916

  • glo: 0705, 0805, 0807, 0811, 0815, 0905, 0915

  • airtel: 0802, 0808, 0812, 0708, 0701, 0901, 0902, 0907

  • etisalat: 0809, 0817, 0818, 0908, 0909

Examples

>>> from fakernaija import Naija
>>> naija = Naija()

>>> phone = naija.phone_number()
>>> print(f"Random phone number: {phone}")
Random phone number: 08051234567

>>> for _ in range(3):
...     print(naija.phone_number())
...
09054519464
09025038192
09016604216

>>> phone = naija.phone_number(network="mtn")
>>> print(f"Random MTN phone number: {phone}")
Random MTN phone number: 08031234567

>>> phone = naija.phone_number(prefix="0909")
>>> print(f"Random phone number with prefix 0909: {phone}")
Random phone number with prefix 0909: 09091234567

>>> phone = naija.phone_number(network="airtel", prefix="0902")
>>> print(f"Random Airtel phone number with prefix 0902: {phone}")
Random Airtel phone number with prefix 0902: 09021234567