Skip to main content
This guide explains how to access GBGroup’s Global Telephone Validation web service product using their Identity Management Platform (IdM), available via SOAP web services. The fundamentals of integrating with the service are described here: Integration Fundamentals

​
Matchcode Global Telephone Validation Service

The global telephone validation service first checks that the provided telephone number conforms to the valid syntax required for a telephone number for the country specified. For all mobile and UK Landline numbers, further real-time checks are then carried out to assess the validity of the number and, for mobiles, such details as whether the number is roaming and the current location. There are two services available - the ‘Full’ service carries out all checks as described above. There is also a ‘Rapid’ service, here results from previous lookups of the Full service are cached for 3 days and the Rapid service looks up these cached results. The advantage of the Rapid service is one of speed and an increased amount of numbers than can be looked up in one webservice call. This has to be offset against the fact that the results are not ‘live’ and there is a small chance of them having changed since being cached. Also, the number looked up may not be in the cache at all. In addition there is a ‘Telephone_Fast’ option whereby the user can specify the number of days to look back in the cache. The Matchcode Validation Service products are available via the Identity Management ExecuteCapture web service method.

​
Global Telephone Validation - Input Criteria

Method: ExecuteCapture The ExecuteCapture method is used to access the Global Telephone Validation product and services by specifying the corresponding profile.

​
Input Details

Type: ExecuteCaptureRequest
Field NameTypeDescription
securityHeaderSecurityHeaderThe username used to access the system including domain name (e.g. user1@domainname.com)
profileRequestProfileRequestCaptureDetails of the request
In the profileRequest element, the profileGuid should be specified as:
ProfileGUID
Global Telephone (Full)454F13CA-8C71-40D6-9FEF-A88D821C99E4
Global Telephone (Rapid)315559EB-94DD-49B8-8277-FEEB42CD6820

​
Telephone Validation Criteria

The input telephone information should be entered into the IdMDataCaptureTelephone data structure: ExecuteCapture → ProfileRequestCapture → ProfileRequestCaptureData → IdMDataCaptureTelephone Type: IdMDataCaptureTelephone
Field NameTypeDescription
numberStringTelephone Number (International format including dialing code e.g. +44)
typeEnumTelephoneSpecifies the type of telephone provided

MOBILE, LANDLINE, UNKNOWN

​
Maximum Telephone Numbers

For the Full service a maximum of 10 numbers can be entered into any one executeCapture request, for the rapid service a maximum of 100 numbers can be entered.

​
Country Code

The 3 letter ISO code for the country can be entered into the countryCode element of the address structure. Note: The country code is used to format numbers that are entered in the ‘local’ format for the country specified (e.g. 012446573333 for UK). If more than one number is validated and they are from different countries then they should be entered in full international format (e.g. +441244657333). ExecuteCapture → ProfileRequestCapture → ProfileRequestCaptureData → IdMDataSearchAddress → countryCode

​
Additional Features

Additional information can be requested to be returned by providing the key value pairs specified below to the ProfileRequestCaptureData → additionalData property. The TELEPHONE_FAST option allows the user specify how many days to look back in the cached results. A value of 0 will mean the lookup is always live, other values will look back in the cache for the number of days set. The advantage of this is one of speed and an increased pool of numbers than can be looked up in one webservice call. This has to be offset against the fact that the results are not ‘live’ and there is therefore an increased chance of the status of the number having changed since being cached. In summary, increasing cache days is likely to improve response times but will reduce the recency of the result. Please note the default setting of the telephone validation service is to reference one day of Cache results, i.e. TELEPHONE_FAST=1 This information should be entered into a IdmDataArrayAdditionalData data structure: ExecuteCapture → ProfileRequestCapture → ProfileRequestCaptureData → additionalData Type: IdmDataArrayAdditionalData Below is a list of addition data fields:
Key MnemonicKey ValueDescription
TELEPHONE_FASTIntegerNumber of days cache to reference

​
Telephone Input XML

The following XML sample demonstrates a request data object containing both an Address and two telephone numbers for validation. Where possible the telephone numbers should be provided with the international dialling code (e.g. +44 for UK) or the country code can be provided in the address object (e.g. GBR for UK). Each telephone number entered allows you to specify a type of either MOBILE, LANDLINE or UNKNOWN. The UNKNOWN type will attempt to work out the correct number type based upon the input format. 
<!-- Request Input Data - Telephone -->
          <req:requestData>
             <req:address>
               <data:countryCode>GBR</data:countryCode>
            </req:address>
            <!-- Telephone Input Data -->
             <req:telephone>
              <data:number>+441244657231</data:number>
              <data:type>LANDLINE</data:type>
             </req:telephone>
             <req:telephone>
              <data:number>07123456789</data:number>
              <data:type>MOBILE</data:type>
             </req:telephone>
 
            <!-- Request Options -->
             <req:options>
              <req:offset>0</req:offset>
              <req:maxReturn>10</req:maxReturn>
             </req:options>
             <req:additionalData tmp="?">
              <data:item>
               <data:key>PAYG</data:key>
               <data:value>Yes</data:value>
              </data:item>
              <data:item>
               <data:key>TELEPHONE_FAST</data:key>
               <data:value>5</data:value>
              </data:item>
            </req:additionalData tmp="?">
         </req:requestData>

{
  "requestData": {
    "address": { "countryCode": "GBR" },
    "telephone": [
      {
        "number": "+441244657231",
        "type": "LANDLINE"
      },
      {
        "number": "07123456789",
        "type": "MOBILE"
      }
    ],
    "options": {
      "offset": "0",
      "maxReturn": "10"
    },
    "additionalData": {
     "data:item": [
         {
           "data:key": "PAYG",
           "data:value": "no"
         },
         {
           "data:key": "TELEPHONE_FAST",
           "data:value": "5"
         }
       ]
    }
  }
}

​
Telephone Output Format

The results of the GB Telephone Web Service search are returned in a ProfileResponseDetails structure with a ProfileResponseDetails → responseType of ‘VALIDATE’. The ProfileResponseDetails structure contains a single ValidateResponse data structure which holds an array of ValidateResponseData records containing the returned validation data per input number. ExecuteCaptureResponse → ProfileResponse [0] → ProfileResponseDetails [0] → ValidateResponse → ValidateResponseData The returned ValidateResponseData data structure is detailed below: Type: ValidateResponseData
Field NameTypeDescription
inputStringThe input telephone number
statusEnumerationSUCCESS if the validation has taken place, FAILURE otherwise
validityFlagEnumerationOverall validation result of the number (VALID, INVALID, UNKNOWN, UNSUPPORTED)
validationCodesIdmDataArrayAdditionalDataArray of key value pairs containing the validation response codes for the number

​
Sample Output XML

The following output XML demonstrates the ProfileResponse for the telephone component. The component name is Global Telephone and the response type is VALIDATE. The validation results for each telephone number will be returned in the same order as input. The array of ValidateResponse data structures contain the individual response details. The primary response value is validityFlag which dictates whether or not the number has been deemed to be valid or not. In addition a series of key value pair response codes are returned for each number, which contain data supplier specific summaries of the input number. 
<!-- Telephone Component Response -->
<req:profileResponseDetails>
  <req:transactionGuid>32FBA7E0-7AE5-43B7-93DC-357B593B4D87</req:transactionGuid>
  <req:componentName>Global Telephone</req:componentName>
  <req:componentStatus>SUCCESS</req:componentStatus>
  <req:componentAction>TelephoneAuto</req:componentAction>
  <req:responseType>VALIDATE</req:responseType>
  <req:notes>[]</req:notes>
 
  <!-- Billing Invoice -->
  <req:invoice>
   <req:invoiceList>
    <req:invoiceGuid>E4C1E94C-F39D-405B-8842-F1F6B1B5763F</req:invoiceGuid>
    <req:billingInformationGuid>A8C19479-A562-4604-B5E2-97A93AEA45D6</req:billingInformationGuid>
    <req:billingPoints>2</req:billingPoints>
    <req:dataSetInvoices>
       <req:dataSetCode>TELEPHONE</req:dataSetCode>
       <req:billingPoints>2</req:billingPoints>
       <req:recordsReturned>2</req:recordsReturned>
       <req:dataLicenceGuid>A8C19479-A562-4604-B5E2-97A93AEA45D6</req:dataLicenceGuid>
    </req:dataSetInvoices>
   </req:invoiceList>
  </req:invoice>
 
  <!-- Response Data -->
  <req:validateResponse>
   <req:resultStatus>VERIFY</req:resultStatus>
   <req:recordsReturned>2</req:recordsReturned>
   <req:responseCount>2</req:responseCount>
 
 
  <!-- Response per Input Number -->
        <req:response>
           <req:input>+441244657321</req:input>
           <req:status>SUCCESS</req:status>
           <req:validityFlag>VALID</req:validityFlag>
           <req:validationCodes>
              <data:item>
                 <data:key>ResultCode</data:key>
                 <data:value>100</data:value>
              </data:item>
              <data:item>
                 <data:key>ResultCodeDescription</data:key>
                 <data:value>Live Number</data:value>
              </data:item>
              <data:item>
                 <data:key>NumberType</data:key>
                 <data:value>LANDLINE</data:value>
              </data:item>
              <data:item>
                 <data:key>InputNumber</data:key>
                 <data:value>+441244657321</data:value>
              </data:item>
              <data:item>
                 <data:key>OutputNumber</data:key>
                 <data:value>01244657321</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryISO3Code</data:key>
                 <data:value>GBR</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryName</data:key>
                 <data:value>United Kingdom</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryPrefix</data:key>
                 <data:value>44</data:value>
              </data:item>
              <data:item>
                 <data:key>OfcomAllocated</data:key>
                 <data:value>true</data:value>
              </data:item>
              <data:item>
                 <data:key>OfcomProvider</data:key>
                 <data:value>BT</data:value>
              </data:item>
           </req:validationCodes>
        </req:response>
 
        <req:response>
           <req:input>07123456789</req:input>
           <req:status>SUCCESS</req:status>
           <req:validityFlag>VALID</req:validityFlag>
           <req:validationCodes>
              <data:item>
                 <data:key>NumberType</data:key>
                 <data:value>MOBILE</data:value>
              </data:item>
              <data:item>
                 <data:key>InputNumber</data:key>
                 <data:value>07123456789</data:value>
              </data:item>
              <data:item>
                 <data:key>OfcomAllocated</data:key>
                 <data:value>true</data:value>
              </data:item>
              <data:item>
                 <data:key>OfcomProvider</data:key>
                 <data:value>Orange</data:value>
              </data:item>
              <data:item>
                 <data:key>OfcomNotes</data:key>
                 <data:value>Mobile services</data:value>
              </data:item>
              <data:item>
                 <data:key>ResultCode</data:key>
                 <data:value>100</data:value>
              </data:item>
              <data:item>
                 <data:key>ResultCodeDescription</data:key>
                 <data:value>Live Number</data:value>
              </data:item>
              <data:item>
                 <data:key>OutputNumber</data:key>
                 <data:value>447123456789</data:value>
              </data:item>
              <data:item>
                 <data:key>Status</data:key>
                 <data:value>DELIVRD</data:value>
              </data:item>
              <data:item>
                 <data:key>IMSI</data:key>
                 <data:value>234330188089882</data:value>
              </data:item>
              <data:item>
                 <data:key>MCC</data:key>
                 <data:value>234</data:value>
              </data:item>
              <data:item>
                 <data:key>MNC</data:key>
                 <data:value>33</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryISO3Code</data:key>
                 <data:value>GBR</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryName</data:key>
                 <data:value>United Kingdom</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalCountryPrefix</data:key>
                 <data:value>44</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalNetworkName</data:key>
                 <data:value>Orange (Everything Everywhere Limited)</data:value>
              </data:item>
              <data:item>
                 <data:key>OriginalNetworkPrefix</data:key>
                 <data:value>79700</data:value>
              </data:item>
              <data:item>
                 <data:key>IsRoaming</data:key>
                 <data:value>false</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingCountryName</data:key>
                 <data:value>United Kingdom</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingNetworkName</data:key>
                 <data:value>T-Mobile UK (Everything Everywhere Limited)</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingCountryPrefix</data:key>
                 <data:value>44</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingNetworkPrefix</data:key>
                 <data:value>79537</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingCountryISO3Code</data:key>
                 <data:value>GBR</data:value>
              </data:item>
              <data:item>
                 <data:key>RoamingCountryMCC</data:key>
                 <data:value>234</data:value>
              </data:item>
              <data:item>
                 <data:key>IsPorted</data:key>
                 <data:value>false</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedCountryName</data:key>
                 <data:value>United Kingdom</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedNetworkName</data:key>
                 <data:value>Orange (Everything Everywhere Limited)</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedCountryPrefix</data:key>
                 <data:value>44</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedNetworkPrefix</data:key>
                 <data:value>74091</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedCountryISO3Code</data:key>
                 <data:value>GBR</data:value>
              </data:item>
              <data:item>
                 <data:key>PortedCountryMCC</data:key>
                 <data:value>234</data:value>
              </data:item>
              <data:item>
                 <data:key>ValidationDate</data:key>
                 <data:value>2015-05-18</data:value>
              </data:item>
              <data:item>
                 <data:key>payg</data:key>
                 <data:value>Contract</data:value>
              </data:item>
           </req:validationCodes>
        </req:response>
  </req:validateResponse>
</req:profileResponseDetails>

{
  "profileResponseDetails": {
    "transactionGuid": "32FBA7E0-7AE5-43B7-93DC-357B593B4D87",
    "componentName": "Global Telephone",
    "componentStatus": "SUCCESS",
    "componentAction": "TelephoneAuto",
    "responseType": "VALIDATE",
    "notes": "[]",
    "invoice": {
      "invoiceList": {
        "invoiceGuid": "E4C1E94C-F39D-405B-8842-F1F6B1B5763F",
        "billingInformationGuid": "A8C19479-A562-4604-B5E2-97A93AEA45D6",
        "billingPoints": "2",
        "dataSetInvoices": {
          "dataSetCode": "TELEPHONE",
          "billingPoints": "2",
          "recordsReturned": "2",
          "dataLicenceGuid": "A8C19479-A562-4604-B5E2-97A93AEA45D6"
        }
      }
    },
    "validateResponse": {
      "resultStatus": "VERIFY",
      "recordsReturned": "2",
      "responseCount": "2",
      "response": [
        {
          "input": "+441244657321",
          "status": "SUCCESS",
          "validityFlag": "VALID",
          "validationCodes": {
            "item": [
              {
                "key": "ResultCode",
                "value": "100"
              },
              {
                "key": "ResultCodeDescription",
                "value": "Live Number"
              },
              {
                "key": "NumberType",
                "value": "LANDLINE"
              },
              {
                "key": "InputNumber",
                "value": "+441244657321"
              },
              {
                "key": "OutputNumber",
                "value": "01244657321"
              },
              {
                "key": "OriginalCountryISO3Code",
                "value": "GBR"
              },
              {
                "key": "OriginalCountryName",
                "value": "United Kingdom"
              },
              {
                "key": "OriginalCountryPrefix",
                "value": "44"
              },
              {
                "key": "OfcomAllocated",
                "value": "true"
              },
              {
                "key": "OfcomProvider",
                "value": "BT"
              }
            ]
          }
        },
        {
          "input": "07123456789",
          "status": "SUCCESS",
          "validityFlag": "VALID",
          "validationCodes": {
            "item": [
              {
                "key": "NumberType",
                "value": "MOBILE"
              },
              {
                "key": "InputNumber",
                "value": "07123456789"
              },
              {
                "key": "OfcomAllocated",
                "value": "true"
              },
              {
                "key": "OfcomProvider",
                "value": "Orange"
              },
              {
                "key": "OfcomNotes",
                "value": "Mobile services"
              },
              {
                "key": "ResultCode",
                "value": "100"
              },
              {
                "key": "ResultCodeDescription",
                "value": "Live Number"
              },
              {
                "key": "OutputNumber",
                "value": "447123456789"
              },
              {
                "key": "Status",
                "value": "DELIVRD"
              },
              {
                "key": "IMSI",
                "value": "234330188089882"
              },
              {
                "key": "MCC",
                "value": "234"
              },
              {
                "key": "MNC",
                "value": "33"
              },
              {
                "key": "OriginalCountryISO3Code",
                "value": "GBR"
              },
              {
                "key": "OriginalCountryName",
                "value": "United Kingdom"
              },
              {
                "key": "OriginalCountryPrefix",
                "value": "44"
              },
              {
                "key": "OriginalNetworkName",
                "value": "Orange (Everything Everywhere Limited)"
              },
              {
                "key": "OriginalNetworkPrefix",
                "value": "79700"
              },
              {
                "key": "IsRoaming",
                "value": "false"
              },
              {
                "key": "RoamingCountryName",
                "value": "United Kingdom"
              },
              {
                "key": "RoamingNetworkName",
                "value": "T-Mobile UK (Everything Everywhere Limited)"
              },
              {
                "key": "RoamingCountryPrefix",
                "value": "44"
              },
              {
                "key": "RoamingNetworkPrefix",
                "value": "79537"
              },
              {
                "key": "RoamingCountryISO3Code",
                "value": "GBR"
              },
              {
                "key": "RoamingCountryMCC",
                "value": "234"
              },
              {
                "key": "IsPorted",
                "value": "false"
              },
              {
                "key": "PortedCountryName",
                "value": "United Kingdom"
              },
              {
                "key": "PortedNetworkName",
                "value": "Orange (Everything Everywhere Limited)"
              },
              {
                "key": "PortedCountryPrefix",
                "value": "44"
              },
              {
                "key": "PortedNetworkPrefix",
                "value": "74091"
              },
              {
                "key": "PortedCountryISO3Code",
                "value": "GBR"
              },
              {
                "key": "PortedCountryMCC",
                "value": "234"
              },
              {
                "key": "ValidationDate",
                "value": "2015-05-18"
              },
              {
                "key": "payg",
                "value": "Contract"
              }
            ]
          }
        }
      ]
    }
  }
}

​
Detailed Telephone Responses

NameDescription
NumberTypeNumber type supplied b within the request(LANDLINE / MOBILE / UNKOWN)
InputNumberNumber as supplied within the request
ResultCodeGBG’s Result code as an interpretation of the Syntax check or results from supplier. (see below)
ResultCodeDescriptionMeaning of the result code
OutputNumberGBG’s reformatted number being used to perform a live check
StatusThe status for the number based as an interpretation from the live HLR lookup
IMSIInternational mobile subscriber identity
MCCMobile country code
MNCMobile network code
OriginalCountryNameOriginal Country name of Mobile number
OriginalNetworkNameOriginal Network name
OriginalCountryPrefixOriginal mobile number country dialling prefix
OriginalNetworkPrefixThe Network code of the mobile number Original Network
OriginalCountryISO3CodeISO 3 country code of Original country for Mobile number
IsRoamingIndication whether the phone is roaming in other country
RoamingCountryNameThe roaming Country name of Mobile number
RoamingNetworkNameOriginal Network name
RoamingCountryPrefixOriginal mobile number country dialling prefix
RoamingNetworkPrefixThe Network code of the mobile number Original Network
RoamingCountryISO3CodeISO 3 country code of Original country for Mobile number
RoamingCountryMCCMobile country code of the country where Mobile number is indicated as roaming
IsPortedIndication whether the mobile number was ported to a different network
PortedCountryNameThe Country name of Mobile number is ported to.
PortedNetworkNameThe ported Network name
PortedCountryPrefixMobile number ported country dialling prefix.
PortedNetworkPrefixThe Network code of the mobile number ported Network
OfcomAllocatedtrue or false - number appears in UK Ofcom number allocation tables (for UK numbers only)
OfcomProviderIf OfcomAllocated is true this shows the provider (e.g. BT or Virgin) that the number was originally allocated to (Note number may have since been ported - for UK numbers only)
OfcomNotesOptional set of notes which Ofcom may provide about the number (for UK numbers only)
ValidationDateDate on which the data was checked

​
Telephone Result Codes

CodeDescriptionDetails
1Unknown SubscriberIndicates that the number is a Canadian landline number. Although valid, in most cases it is unable to process SMS traffic and voice mail can be associated with such numbers.
100Live NumberNumber is live on telecoms provider network
110Number allocated to BT, likely to be live or unobtainableFor BT exchanges, likely to be live or unobtainable (see 610)
120Live number. But phone is switched offLive mobile but detailed info not available due to mobile being switched off
150Live number. Assumed mobileWhere an ‘unknown’ number could not be determined to be landline or mobile, the number is validated as a mobile and found to be live
200Live Call BarredAt the time of validation the number was ‘live’ but an attempt to call it would result in a ‘call barred’ message.
300Dead numdberDead / unobtainable / unconnectable / rejected number.
310Number allocated to non-BT provider, likely to be deadFor non-BT exchanges, likley to be dead. (see 610)
400Failed syntax checkPre-processing of the numbers is made to check or a valid number format. E.g. numbers must be between 8 and 11 digits, must not contain non-numeric characters (although brackets, spaces and hyphens are stripped out). Also for UK numbers a check is made against a list of Ofcom registered codes to ensure that the number has a correct area code and has been allocated. Also attempts to landline verify a mobile number or vice versa.
500Number ChangedLive number but if you phoned this number, a recording will give you a new number to call.
600Retry ‘Normal’Unverified - Status unknown. Contact cannot be made with the number (e.g. no response at all) so no further information can be given regarding whether the number is good or not i.e. ‘status unknown’, classified as a retry because trying again later may yield a positive result
610Retry UnobtainableThe number would give a ‘number unobtainable’ message. Reasons for this are many (customer has not paid the bill, or incoming calls not accepted). The number is registered at the exchange but unobtainable at the time of validation, which is subtly different from a dead number (i.e. not available at all). Classified as a retry as it’s possible that this number may become available after some time. Now split into 310 (non-BT Exchange) and 110 (BT Exchange).
620Retry Number Out Of OrderThe number is registered but could not be reached at the time of validating due to faults with the equipment at the other end of the line. This is classified as a retry as the fault may be temporary.
630Retry Network Out Of OrderThe number is registered but could not be reached at the time of validating due to faults with the telephone network. This is classified as a retry as the fault may be temporary.
640Retry Network CongestionThe number could not be validated because the telephone network reported congestion at the time of validation. This is classified as a retry as network congestion tends to be temporary.
650Retry Temporary Equipment FailureThe number is registered however there was a failure with the call due to a temporary fault of equipment at the network.
660Retry. Mobile Phone temporarily unavailableThe mobile validation service is temporarily unavailable. This is classified as a retry as the fault may be temporary.
700Valid number format but live check not supported: Country = country nameOur live Landline Verification service only operates on UK landline numbers. If the number entered was a non UK number but conformed to the correct syntax for a landline for that country then this result code is returned.
710Not Live Mobile, Indicated LandlineSome countries (e.g. USA and Canada) do not allocate specific number ranges to mobile phones. If the number submitted is defined as “MOBILE” and it is discovered to be a landline this result will be returned. Note: the number may be live - it is just not a mobile so won’t have had a full live validation performed.
720Indicated Landline, Valid formatSome countries (e.g. USA and Canada) do not allocate specific number ranges to mobile phones. If the number submitted is defined as “UNKNOWN” and it is discovered to be a landline this result will be returned. Note: the number may be live - it is just not a mobile so won’t have had a full live validation performed.
730HLR look-up unavailable for this networkFull live validation is not possible on some Mobile Networks (e.g. older CDMA networks). If this is the case, as much information as possible will be returned but a a full live validation cannot be performed.
740Mobile DetectedNumber was submitted as landline, but mobile was detected
750Landline DetectedNumber was submitted as mobile, but landline was detected
800Number not found in cache for Rapid serviceThe number was not in the cache when using the Global Telephone Rapid service
900New status information received from Mobile serviceNew status information has been received from mobile service. This should be used in conjuncton with the status field to determine the result.

​
Error Information

Information on possible error codes is given here: Error Code Information