Single Number Check
The single number check API can be called using the following syntax:
https://api.tpsmydata.co.uk?api_key=[your api key]&tel=telephone_number
For example:
https://api.tpsmydata.co.uk?api_key=abc123abc123abc123&tel=01442590800
Your api key can be found in the ‘Your Details’ section of tpsmydata.
telephone_number should be the telephone number to be checked in standard national format (e.g. 01442590800)
The api returns data in JSON format
Example:
{
"phone_format_status":"VALID",
"data":{
"tel_no":"01442590800",
"national":"01442 590800",
"international":"+44 1442 590800",
"line_type":"FIXED_LINE",
"location":"Hemel Hempstead, United Kingdom",
"original_carrier":"FleXtel Limited",
"on_tps":"NO",
"on_ctps":"NO",
"check_date":"28.11.2019",
"original_carrier_allocation_date":"24.10.2005",
"remaining_credits":"738"}
}
tpsmydata returns the following data via the api:
| Data | Example | Description |
|---|---|---|
| Phone Format Status | VALID | Phone format Status (VALID, INVALID) |
| Tel No | 01442590800 | as supplied in api call |
| National | 01442 590800 | National format |
| International | +44 1442 590800 | Standard international format |
| Line Type | FIXED_LINE | Phone type (FIXED_LINE, MOBILE, PREMIUM etc.) |
| Location | Hemel Hempstead, United Kingdom | Geographical Location |
| Original Carrier | FleXtel Limited | Original Line Carrier (Source: Ofcom) |
| On TPS | NO | Is number on TPS? (YES, NO) |
| On CTPS | NO | Is number on CTPS? (YES, NO) |
| Original Carrier Allocation Date | 24.10.2005 | Date number range was allocated to original carrier (source: Ofcom) |
| Remaining Credits | 738 | Remaining Credits available |