colprefix

A lightweight and modern library for validating Colombian phone number prefixes.

Installation

npm install colprefix

Usage

Import the library into your JavaScript or TypeScript project:

import { validatePrefix } from "colprefix"

const result = validatePrefix("+573112345678")

console.log(result)
// Output: { valid: true, operator: "Claro" }

API

validatePrefix(phoneNumber: string)

Validates if the given phone number has a valid Colombian prefix.

• phoneNumber: A string containing the phone number in any format (with +57, 57, or just digits).

Returns

• valid (boolean): Indicates if the prefix is valid.
• operator (string | null): The name of the operator if valid, otherwise null.

Examples

Valid prefix

import { validatePrefix } from "colprefix"

console.log(validatePrefix("3001234567"))
// { valid: true, operator: "Tigo" }

console.log(validatePrefix("+573051234567"))
// { valid: true, operator: "ETB" }

Invalid prefix

import { validatePrefix } from "colprefix"

console.log(validatePrefix("3991234567"))
// { valid: false, operator: null }

Supported Operators

• Claro
• Movistar
• Tigo
• ETB
• VirginMobile
• Avantel
• Wom
• SETROC
• SumaMovil

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Disclaimer

While this library provides accurate validation of Colombian mobile prefixes based on official public data, please note that due to number portability, the original operator associated with a prefix may not reflect the current service provider. Therefore, the operator field returned is indicative based on the original assignment and may not represent the current carrier. The primary guarantee of this library is the validation of whether the prefix is valid within the Colombian mobile numbering plan.

License

MIT © colprefix