api:mvno:account:changesim
Table of Contents
API : MVNO Account Change SIM
Introduction
This request will change the SIM card for the specified MVNO account. It is used when the SIM card is lost (e.g. stolen), becomes defective or needs to be changed to another form factor.
Request
| URL | https://api.telecomx.dk/mvno/ACCOUNT_ID/changesim/NEW_SIM_NUMBER | |
|---|---|---|
| Method | GET | |
| Access level | OWNER when user belongs to the customer. RESELLER if customer belongs to the reseller. ADMIN. |
|
| Param | ACCOUNT_ID | Id of the MVNO account (24 hex-char string). |
| NEW_SIM_NUMBER | ICC number of the new SIM card to use (11-19 digits). If the value is “eSim”, the MVNO account will switch SIM to a chosen eSim. If the value is “autoAssign”, the MVNO account will switch to an auto-assigned SIM. | |
Query example
https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/changesim/1234567890123456789 https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/changesim/eSim https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/changesim/autoAssign
Response
| Json object | ||
|---|---|---|
| success | Boolean | True on success |
| mvnoSim | Object | The newly assigned SIM cards settings - see below. |
| mvnoSim.simNumber | String | ICC number. |
| mvnoSim.imsi | String | IMSI number. |
| mvnoSim.network | String | Network provider: TELENOR, TDC. |
| mvnoSim.puk1 | String | Puk code 1. |
| mvnoSim.puk2 | String | Puk code 2. |
| mvnoSim.pin1 | String | Pin code 1. |
| mvnoSim.pin2 | String | Pin code 2. |
| mvnoSim.formFactor | String | Size of SIM card: 'MINI_MICRO', 'NANO', 'MINI_MICRO_NANO'. |
Example
{ success: true, mvnoSim: { simNumber: '8945020184621234567', imsi: '1234578901', network: 'TELENOR', puk1: '12345678', puk2: '12345678', pin1: '1234', pin2: '1234', formFactor: 'MINI_MICRO' } }
Errors
| Error code | Message | Description |
|---|---|---|
| 404 | mvnoAccount | MVNO account not found |
| 404 | sim | SIM card not found or not available |
| 403 | state | SIM cannot be changed due to the current state of the account |
| 403 | porting | SIM cannot be changed while the account is in porting |
| 500 | internal_error | <Unspecified> |
api/mvno/account/changesim.txt · Last modified: 2024/02/19 11:43 by Joakim Andersen