Want to know where a phone number is from, and which carrier it belongs to? This endpoint gives you the answer.
The 11-digit mainland China mobile number to look up.
Provide a mainland China phone number and the endpoint returns its registered location (province and city), the carrier (China Mobile, China Unicom, or China Telecom), and the landline area code of that city (area_code).
phoneThe 11-digit mainland China mobile number to look up.
Lookup succeeded. Returns the registered location and carrier for the number.
{
"city": "深圳",
"province": "广东",
// Carrier name (returned in Chinese, e.g. 移动 / 联通 / 电信).
"sp": "联通",
// Landline area code of the registered city, as a string with the leading zero (e.g. `010`, `0755`). Municipalities return Beijing `010`, Shanghai `021`, Tianjin `022`, Chongqing `023`. Returns an empty string for Hong Kong, Macau, Taiwan, special number ranges, or unrecognized cities.
"area_code": "0755"
}Invalid request parameters. Check that you supplied the phone parameter and that it is a valid 11-digit mobile number.
{
"code": "INVALID_ARGUMENT",
"details": {},
"message": "Missing or invalid 'phone' parameter."
}Lookup failed. The phone number location data may be temporarily unavailable — please try again later.
{
"code": "INTERNAL_SERVER_ERROR",
"details": {},
"message": "Failed to query phone information."
}Pick your language to see usage examples
curl 'https://uapis.cn/api/v1/misc/phoneinfo?phone=13800138000'Phone Number Location Lookup follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.
No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.
Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.