Telephone Operator Detection API

Telephone Operator Detection API - teloperatordet (also known as Telephone Operator Recognition API or Telephone Operator Detector API) is a cross browsers REST API which get a JSON input with a string containing a phone number (only from Romania at this time) and returns a JSON string which contains the current operator, number type (geo, non-geo or mobile) and previous operator if the number has been ported. If the phone number is not recognized you will get the message "Incorrect phone number" as shown in the API response below.

Allthough this Automatic Telephone Operator Detection API (currently we do not offer a Telephone Operator Detection sdk) is intended for software development and therefore developers, we have also here an Telephone Operator Detection online application that may be used to check the input and output JSONs of the API. The necessary steps are written below, basically for this real time Telephone Operator Detection API you send an authorized POST request in JSON format to the API endpoint and you get as JSON response the output as described below through parameters and examples.

This Telephone Operator Detection API is useful for a large number of domains like apps for: e-commerce, telecommunications etc. You own the commercial copyright of the resulted JSON with no additional fee meaning you may use it in your own apps for sale.

For using our Telephone Operator Detection API and/or APP you must create an account (free of charge, no card required), activate it from your received email, login and then start your TRIAL package with no fees as you can see at our pricing packages. After you have tested the API and/or APP and you are satisfied, you may buy a paid package. You will always see at your Admin Console page the real resources consumption in real time, your invoices, you may see/edit/delete your profile or export log consents as GDPR instructed, you may read our FAQs.

Telephone Operator Detection APP

Phone Number (Only Digits)



API Endpoint (method POST):
https://gatiosoft.ro/teloperatordet.aspx
Headers:
Authorization: Basic //Your username:password are base64 encoded string
Content-Type: application/json
Accept: application/json
JSON Request Body (change inputs here and see in real time below):
                   {
  "phone_number": "0314004600"
}
               
JSON Response From API (change inputs here and see in real time below):
{
  "current_operator": "RCS & RDS",
  "previous_operator": "none",
  "number_type": "Geo"
}
JSON Response (Example) From API in case of ERROR:

 [
  {
    "cd": "1001",
    "description": "The authorization header Is either empty Or isn't Basic"
  }
]

Request Parameters Table

Parameter Name
Parameter Description
phone_number
This is the input phone number [string] which will be verified to detect the Telephone Operator.

Response Parameter Table

Parameter Name
Parameter Description
current_operator 
This is the current operator as  [string] of the phone number at the moment that request is made.
previous_operator
This is the previous operator as  [string] of the phone number if the phone number has been ported to the current_operator. If the phone number is not ported then this field has the value "none".
number_type
This is the type of the phone number [string] and the values may be "geo", "non-geo" or "mobile".

Response Error Codes Table

Parameter Name
Parameter Description
cd

This is the error code which may be:

  • 1001
  • 1002
  • 1003
  • 1004
  • 1005
  • 1006
  • 1007
  • 1008
  • 1009
  • 1010
  • 1011
  • 1012
  • 1013
  • 1014
  • 1015
  • 1016
  • 2001
description

This is the description of the error code which may be:

  • 1001 - The authorization header is either empty or isn't Basic.
  • 1002 - Daily requests number exceeded in TRIAL mode!
  • 1003 - Trial expired!
  • 1004 - Requests number exceeded!
  • 1005 - Package expired!
  • 1006 - No invoice!
  • 1007 - Reader is NULL for TRIAL!
  • 1008 - Cannot Read if TRIAL exists!
  • 1009 - Error connecting to database looking for TRIAL! (and a detailed description message of the encountered error)
  • 1010 - Reader is NULL for Invoice!
  • 1011 - Cannot Read if Invoice exists!
  • 1012 - Error connecting to database! (and a detailed description message of the encountered error)
  • 1013 - Input request too long! Maximum 20 chars per request are allowed / Nothing to upload / Only Digits allowed
  • 1014 - Invalid request data! (and a detailed description message of the encountered error)
  • 2001 - Invalid request data after passing to the API (and a detailed description message of the encountered error)

Source Code Examples for Using Our Telephone Operator Detection API

                       
Imports System
Imports System.Text
imports System.Collections.Generic
Imports System.Net
Imports Newtonsoft.Json

Public Class Telephone_Operator_detection_api
    Public Class ResponseFields
	 Public Property current_operator As String
         Public Property previous_operator As String
         Public Property number_type As String
    End Class

    Public Class ErrorFields
        Public Property cd As String
        Public Property description As String
    End Class

    Protected Sub SendRequest()
        Dim Client As WebClient = New WebClient()
        Dim credentials As String = Convert.ToBase64String(Encoding.ASCII.GetBytes("your_username:your_password"))
        Client.Headers(HttpRequestHeader.Authorization) = String.Format("Basic {0}", credentials)
        Client.Headers(HttpRequestHeader.Accept) = "application/json"
        Client.Headers(HttpRequestHeader.ContentType) = "application/json"
	Client.BaseAddress = "https://gatiosoft.ro/teloperatordet.aspx"
        Dim resString As String = ""

        Try
            Dim js As String = "Replace this string with your JSON Request Body string like in the example above on the website"
            Dim reqString As Byte() = Encoding.UTF8.GetBytes(js)
            Dim url As Uri = New Uri(Client.BaseAddress)
            Dim resByte As Byte() = Client.UploadData(url, "post", reqString)
            resString = Encoding.UTF8.GetString(resByte)

	    If resString.IndexOf("current_operator") > 0 Then
                Dim r As ResponseFields = New ResponseFields()
                r = JsonConvert.DeserializeObject(Of ResponseFields)(resString)
                Console.Write(resString)
            Else
		Dim e As list(of ErrorFields) = New list(of ErrorFields)
		e = JsonConvert.DeserializeObject(Of list(of ErrorFields))(resString)
                Console.Write(e(0).cd)
                Console.Write(e(0).description)
            End If

            Client.Dispose()
        Catch exception As Exception
            Dim ex As System.Exception = exception
            Console.Write("ERROR: " & resString & ex.Message)
        End Try
    End Sub

    Public Shared Sub Main()
	Dim b As Telephone_Operator_detection_api = New  Telephone_Operator_detection_api
        b.SendRequest()
    End Sub
End Class



TelOperatorDet Online Video Presentation

Telephone Operator Detection API, TelOperatorDet is in the video presentation below. There are several search terms which you may use like: Telephone Operator Detection api, Telephone Operator Detection sdk, Telephone Operator Detection c#, Telephone Operator Detection online, Telephone Operator Detection, automatic Telephone Operator Detection, Telephone Operator Detection python, Telephone Operator Detection python, real time Telephone Operator Detection python, python Telephone Operator Detection, image processing Telephone Operator Detection.

 



Pricing Packages

Please choose one of the below pricing packages for start using our Telephone Operator Detection API and online APP!

Start TRIAL
No catches

  • 7 days TRIAL
  • Use our cloud REST API and online APP
  • Maximum 50 requests per DAY in trial period
  • You do NOT own the commercial copyright for using the API in your apps in trial period.
  • Get Current Telephone Operator from input phone number as string.
  • Get Previous Telephone Operator from input phone number as string if the phone number has been ported.
  • Get Number Type (fix or mobile) from input phone number as string.
  • Unlimited Devices
  • Administration console
  • Support through online chat and/or tickets
  • We do NOT allow spam accounts for TRIAL



Monthly TIER
Popular

  • 80 USD per month
  • Use our cloud REST API and online APP
  • Maximum 15000 requests per month
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get Current Telephone Operator from input phone number as string.
  • Get Previous Telephone Operator from input phone number as string if the phone number has been ported.
  • Get Number Type (fix or mobile) from input phone number as string.
  • Unlimited Devices
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Yearly TIER
(15% Discount)

  • 816 USD per year
  • Use our cloud REST API and online APP
  • Maximum 15000 requests per month
  • Maximum 50 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get Current Telephone Operator from input phone number as string.
  • Get Previous Telephone Operator from input phone number as string if the phone number has been ported.
  • Get Number Type (fix or mobile) from input phone number as string.
  • Unlimited Devices
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Note: VAT rate may be added or not, function to your country and/or if you are a taxable person or company.