This article contains the NeuTRAFIX Buyer API endpoints required to validate the Mobile Number Portability (MNP) Lookup Integration.
These APIs allow you to:
Retrieve the list of available MNP vendors and pricing
Perform real-time MNP lookups to detect the current operator/carrier of a mobile number (ported vs non-ported)
Review stored lookup history records including timestamps, pricing, and full vendor response payloads
Environment
Base URL: https://apiv2.neutrafix.net
Authentication: Digest Auth (buyer credentials)
Billing: Each successful vendor response triggers a lookup charge (even if the vendor returns an error such as invalid number)
Recommended Testing Tool
Postman (Digest Auth configured once at folder level)
AUTHORIZATIONDigest AuthThis folder is using Digest Auth from collectionNeuTrafiX
GETList MNP Vendors
https://apiv2.neutrafix.net/buyers/mnp/vendorsEndpoints used to retrieve configured MNP vendors available to the buyer, including vendor IDs and lookup pricing.
Use this first to confirm the available vendor and select the correct i_mnp_vendor for testing.
AUTHORIZATIONDigest AuthThis request is using Digest Auth from collectionNeuTrafiX
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/vendors'
Example Response
{
"status": "success",
"mnp_vendors": [
{
"name": "TMT",
"i_mnp_vendor": "1",
"short_bio": "",
"request_price": "0.0015"
}
]
}
POSTLookup
https://apiv2.neutrafix.net/buyers/mnp/lookupReal-time MNP lookup endpoints used to determine the current mobile network operator for a destination number.
Supports validation of both:
Non-ported numbers (current carrier = original carrier)
Ported numbers (current carrier ≠ original carrier, LRN may be present depending on region)
Required parameters include cld, i_account, and i_mnp_vendor.
AUTHORIZATIONDigest AuthThis request is using Digest Auth from collectionNeuTrafiX
Bodyformdatacld13652927890
The destination phone number to be checked for Mobile Number Portability (MNP). Provide the full number in international format without “+” (digits only). Example: 19542405411 (US), 13652927897 (Canada).
i_account35
Buyer account identifier used for billing and balance validation. The platform will apply the lookup charge against this account (or according to the account’s Use Balance Of setting). use accounts api to find your i_account id.
i_mnp_vendor1
The MNP vendor ID to be used for the lookup request. Must match a valid vendor returned from the List MNP Vendors endpoint.
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/lookup' \
--form 'cld="13652927890"' \
--form 'i_account="35"' \
--form 'i_mnp_vendor="1"'
Example Response
No response body
This request doesn't return any response body
POSTMNP Lookup History
https://apiv2.neutrafix.net/buyers/mnp/historyEndpoints used to retrieve stored MNP lookup history records for audit and reporting purposes.
Records include:
Lookup timestamp (ts)
Pricing charged (price)
Buyer account details (i_account)
Country mapping (country_name)
Full vendor response payload (response)
Supports filtering by date range, vendor, pagination, and optional prefix filtering.
BodyformdataprefixOptional prefix filter applied to the stored lookup number (CLD). Useful for narrowing results by country calling code or leading digits. Example: prefix 3 typically matches numbers beginning with 3xx... (e.g., Portugal 351...).
i_mnp_vendor1
The MNP vendor ID to be used for the lookup request. Must match a valid vendor returned from the List MNP Vendors endpoint.
date_from2026-01-01 00:00:00
Start timestamp (inclusive) for filtering lookup history results. Format must be: YYYY-MM-DD HH:MM:SS URL encoding is required when passed in the query string (spaces become %20).
date_to2026-01-22 00:00:00
End timestamp (inclusive) for filtering lookup history results. Format must be: YYYY-MM-DD HH:MM:SS URL encoding is required when passed in the query string.
limit10
Maximum number of history records returned per request (pagination size). Recommended values: 5–100 depending on testing needs.
off0
Pagination offset (starting position). Use off=0 for the first page, then increase by limit for subsequent pages.
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/history' \
--form 'i_mnp_vendor="1"' \
--form 'date_from="2026-01-01 00:00:00"' \
--form 'date_to="2026-01-22 00:00:00"'
Example Response
{
"status": "success",
"mnp_drs": [
{
"i_mnp": "2",
"number": "13652927890",
"i_account": "35",
"i_customer": "15",
"i_mnp_vendor": "1",
"ts": "2026-01-21 00:24:11",
"price": "0.001500",
"response": {
"number": 13652927890,
"current_carrier": {
"lrn": null,
"mcc": "302",
"mnc": "610",
"name": "Bell Mobility-SVR/2",
"spid": "152054",
"ocn": "6574"
},
"original_carrier": {
"mcc": "302",
"mnc": "610",
"name": "Bell Mobility-SVR/2",
"spid": "152054",
"ocn": "6574"
},
"ported": false,
"status": 0,
"status_message": "Success",
"type": "mobile"
},
"account_name": "TCXC PROD",
"vendor_name": "TMT",
"country_name": "CANADA",
"description": "Ontario Mobile/Fixed Line"
},
{
"i_mnp": "1",
"number": "351915497228",
"i_account": "35",
"i_customer": "15",
"i_mnp_vendor": "1",
"ts": "2026-01-20 19:05:54",
"price": "0.001500",
"response": {
"number": 351915497228,
"current_carrier": {
"lrn": null,
"mcc": "268",
"mnc": "01",
"name": "Vodafone Comunicacoes Pessoais",
"spid": "351500",
"ocn": null
},
"original_carrier": {
"mcc": "268",
"mnc": "01",
"name": "Vodafone Comunicacoes Pessoais",
"spid": "351500",
"ocn": null
},
"ported": false,
"status": 0,
"status_message": "Success",
"type": "mobile"
},
"account_name": "TCXC PROD",
"vendor_name": "TMT",
"country_name": "PORTUGAL",
"description": "Mobile - Vodafone"
}
]
}
This article contains the NeuTRAFIX Buyer API endpoints required to validate the Mobile Number Portability (MNP) Lookup Integration.
These APIs allow you to:
Retrieve the list of available MNP vendors and pricing
Perform real-time MNP lookups to detect the current operator/carrier of a mobile number (ported vs non-ported)
Review stored lookup history records including timestamps, pricing, and full vendor response payloads
Environment
Base URL:
https://apiv2.neutrafix.netAuthentication: Digest Auth (buyer credentials)
Billing: Each successful vendor response triggers a lookup charge (even if the vendor returns an error such as invalid number)
Recommended Testing Tool
Postman (Digest Auth configured once at folder level)
GETList MNP Vendors
Endpoints used to retrieve configured MNP vendors available to the buyer, including vendor IDs and lookup pricing.
Use this first to confirm the available vendor and select the correct i_mnp_vendor for testing.
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/vendors'
Example Response
{
"status": "success",
"mnp_vendors": [
{
"name": "TMT",
"i_mnp_vendor": "1",
"short_bio": "",
"request_price": "0.0015"
}
]
}POSTLookup
Real-time MNP lookup endpoints used to determine the current mobile network operator for a destination number.
Supports validation of both:
Non-ported numbers (current carrier = original carrier)
Ported numbers (current carrier ≠ original carrier, LRN may be present depending on region)
Required parameters include cld, i_account, and i_mnp_vendor.
13652927890
The destination phone number to be checked for Mobile Number Portability (MNP). Provide the full number in international format without “+” (digits only). Example: 19542405411 (US), 13652927897 (Canada).
35
Buyer account identifier used for billing and balance validation. The platform will apply the lookup charge against this account (or according to the account’s Use Balance Of setting). use accounts api to find your i_account id.
1
The MNP vendor ID to be used for the lookup request. Must match a valid vendor returned from the List MNP Vendors endpoint.
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/lookup' \ --form 'cld="13652927890"' \ --form 'i_account="35"' \ --form 'i_mnp_vendor="1"'
Example Response
No response body This request doesn't return any response body
POSTMNP Lookup History
Endpoints used to retrieve stored MNP lookup history records for audit and reporting purposes.
Records include:
Lookup timestamp (
ts)Pricing charged (
price)Buyer account details (
i_account)Country mapping (
country_name)Full vendor response payload (
response)
Supports filtering by date range, vendor, pagination, and optional prefix filtering.
Optional prefix filter applied to the stored lookup number (CLD). Useful for narrowing results by country calling code or leading digits. Example: prefix 3 typically matches numbers beginning with 3xx... (e.g., Portugal 351...).
1
The MNP vendor ID to be used for the lookup request. Must match a valid vendor returned from the List MNP Vendors endpoint.
2026-01-01 00:00:00
Start timestamp (inclusive) for filtering lookup history results. Format must be: YYYY-MM-DD HH:MM:SS URL encoding is required when passed in the query string (spaces become %20).
2026-01-22 00:00:00
End timestamp (inclusive) for filtering lookup history results. Format must be: YYYY-MM-DD HH:MM:SS URL encoding is required when passed in the query string.
10
Maximum number of history records returned per request (pagination size). Recommended values: 5–100 depending on testing needs.
0
Pagination offset (starting position). Use off=0 for the first page, then increase by limit for subsequent pages.
Example Request
curl --location 'https://apiv2.neutrafix.net/buyers/mnp/history' \ --form 'i_mnp_vendor="1"' \ --form 'date_from="2026-01-01 00:00:00"' \ --form 'date_to="2026-01-22 00:00:00"'
Example Response
{
"status": "success",
"mnp_drs": [
{
"i_mnp": "2",
"number": "13652927890",
"i_account": "35",
"i_customer": "15",
"i_mnp_vendor": "1",
"ts": "2026-01-21 00:24:11",
"price": "0.001500",
"response": {
"number": 13652927890,
"current_carrier": {
"lrn": null,
"mcc": "302",
"mnc": "610",
"name": "Bell Mobility-SVR/2",
"spid": "152054",
"ocn": "6574"
},
"original_carrier": {
"mcc": "302",
"mnc": "610",
"name": "Bell Mobility-SVR/2",
"spid": "152054",
"ocn": "6574"
},
"ported": false,
"status": 0,
"status_message": "Success",
"type": "mobile"
},
"account_name": "TCXC PROD",
"vendor_name": "TMT",
"country_name": "CANADA",
"description": "Ontario Mobile/Fixed Line"
},
{
"i_mnp": "1",
"number": "351915497228",
"i_account": "35",
"i_customer": "15",
"i_mnp_vendor": "1",
"ts": "2026-01-20 19:05:54",
"price": "0.001500",
"response": {
"number": 351915497228,
"current_carrier": {
"lrn": null,
"mcc": "268",
"mnc": "01",
"name": "Vodafone Comunicacoes Pessoais",
"spid": "351500",
"ocn": null
},
"original_carrier": {
"mcc": "268",
"mnc": "01",
"name": "Vodafone Comunicacoes Pessoais",
"spid": "351500",
"ocn": null
},
"ported": false,
"status": 0,
"status_message": "Success",
"type": "mobile"
},
"account_name": "TCXC PROD",
"vendor_name": "TMT",
"country_name": "PORTUGAL",
"description": "Mobile - Vodafone"
}
]
}