Frequently Asked Question

TeleInfo - Phone Number lookup and Reputation

Last Updated 7 days ago

TeleInfo API

Overview

The TeleInfo API provides detailed information about a given phone number, including its location, carrier information, user reputation, and number of searches. It combines data from multiple sources.

Version

1.000

Endpoint

/v2/teleinfo.php

Authentication

This API requires authentication using an API key. The key should be passed in the HTTP_X_API_KEY header.

Request Parameters

Parameter	Type	Description
phone	string	The phone number to look up (required, 10-12 digits)

Response

The API returns a JSON object with the following structure:

Field	Type	Description
status	string	"success" if the lookup was successful, "fail" otherwise
result	string	A concatenated string of location, rating, reviews, and carrier information
rating	string	User reputation rating + values are good, - values are bad
reviews	string	Number of searches/reviews from various online sources

Example Response (Success)


{
    "result": "London 0(0) Colt Technology Services fixed line",
    "status": "success",
    "rating": -10,
    "reviews": 44
}

Example Response (Error)


{
  "result": "bad number",
  "status": "fail"
}

Error Handling

If the phone number is invalid (not 10-12 digits): {"result": "bad number", "status": "fail"}
If there's an authentication error: {"status": "[validation status]"}
If the lookup fails: The status will still be "success", but the rating will be "FAIL" and reviews will be 0

Notes

The API combines data from a number of course.
The phone number is sanitised to remove non-digit characters and is converted to both UK and E.164 formats for different lookups.

Security

Ensure that the API key is kept secure and not exposed in client-side code.

Limitations

The API is primarily designed for UK phone numbers.
The accuracy and completeness of the data depend on multiple external services.