| Field | Description |
|---|---|
| API family name | Tenure |
| API family owner | Vodafone |
| API summary | Establishes a level of trust against the mobile ID by verifying the length of tenure for a mobile user who is bound to a mobile number with their current mobile operator; tenure means the period of time a MSISDN has been associated with a specific user with their current CSP. API checks whether the lifetime tenure of a given MSISDN is longer than an input date and indicates the type of mobile contract. [Use Case]: Enterprises can use Tenure API to gauge and establish a level of trust (or Trust Score) with a mobile user who is associated with a specific mobile number, based on how long they have been associated with that number. |
| Technical viability | The data for this API comes from backend systems/sources (i.e. CRM). |
| Commercial viability | To Establish level of trust (or Trust Score) against a mobile ID (MSISDN). The Tenure API will return a True or False answer as to whether the customer's tenure with an operator has been longstanding. [Example]: Customer submits MSISDN to understand if the mobile number has been registered to a CSP for longer than a specific date. * Sample Request: {"tenure_before_date":{"value": "2019-01-15"}} * API Response: True/False - if tenure is longer than specified date + billing segment (PAYG/PAYM/Business) * Sample Response: "tenure_before_date_check": true, "billing_segment": "PAYM" |
| YAML code available? | YES |
| Validated in lab/productive environments? | YES |
| Validated with real customers? | YES - TMT Analysis |
| Validated with operators? | YES - Telefonica, Hutchinson Group |
| Supporters in API Backlog Working Group | Telefonica, Deutsche Telekom, Orange, KDDI |