From 7902ab2078e5b59ff2e6d6840d11b95561a4ee15 Mon Sep 17 00:00:00 2001
From: Gregory Liokumovich <Gregory.Liokumovich@ericsson.com>
Date: Fri, 21 Jun 2024 08:58:29 +0200
Subject: [PATCH] =?UTF-8?q?phone=20number=20instead=20of=20MSISDN=20to=20f?=
 =?UTF-8?q?ollow=20=C2=96communalities=20guidelines?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 code/API_definitions/sim_swap.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/code/API_definitions/sim_swap.yaml b/code/API_definitions/sim_swap.yaml
index cf6390f..4656816 100644
--- a/code/API_definitions/sim_swap.yaml
+++ b/code/API_definitions/sim_swap.yaml
@@ -24,7 +24,7 @@ info:
     **SIM swap**:
     A SIM swap is a process in which a user's mobile phone number (MSISDN) is associated with a new SIM card (IMSI). This is typically done by contacting the user's mobile service provider and requesting a new SIM card for various reasons, such as a lost or damaged SIM card or upgrading to a new phone.
 
-    SimSwap also happens during other actions like changing user's phone number, changing mobile service provider keeping user's mobile phone number or when activating a new SIM associated to the same phone number, known as multisim service.
+    SIM swap also happens during other actions like changing user's phone number, changing mobile service provider keeping user's mobile phone number or when activating a new SIM associated to the same phone number, known as multisim service. New subscription is considered as a SIM swap as well, the MSISDN which can be used by another person earlier, is associated with a SIM card it was not associated before.   
 
     # API functionality
 
@@ -72,13 +72,13 @@ paths:
             - sim-swap
       tags:
         - Retrieve SIM swap date
-      description: Get timestamp of last MSISDN <-> IMSI pairing change for a mobile user account provided with MSIDN.
+      description: Get timestamp of last SIM swap event for a mobile user account provided with phone number.
       operationId: retrieveSimSwapDate
       parameters:
         - $ref: '#/components/parameters/x-correlator'
       requestBody:
         description: |
-          Create a SIM swap date request for a MSISDN identifier.
+          Create a SIM swap date request for a phone number.
         content:
           application/json:
             schema:
@@ -125,7 +125,7 @@ paths:
         - $ref: '#/components/parameters/x-correlator'
       requestBody:
         description: |
-          Create a check SIM swap request for a MSISDN identifier.
+          Create a check SIM swap request for a phone number.
         content:
           application/json:
             schema:
@@ -307,7 +307,7 @@ components:
           example:
             status: 409
             code: CONFLICT
-            message: Another request is created for the same MSISDN
+            message: Another request is created for the same phone number
     Generic500:
       description: Server error
       headers: