Select and Lock Local Network

Brief Description

Version:

v4

Use Case

After negotiation and pre-configuration with Linkage, SIM cards with specific data plans can select and lock the local network operator in designated regions.

Country	mcc	Operator	mnc
USA	310	ATT	410
USA	311	Verizon	480
USA	310,311	Verizon+ATT	410,480
USA	310	T-mobile	260
France	208	Orange	01
France	208	Bouygues Telecom	20
France	208	SFR	10
France	208,208	Orange and Bouygues	01,20
Germany	262	Vodafone	02
Germany	262	Telefonica	07
Germany	262	Deutsch Telecom	01
Germany	262,262	Telefonica and Deutsch Telecom	07,01
Italy	222	Vodafone	10
Italy	222	Iliad	50
Italy	222	Wind	88
Italy	222	Telecom Italia	01
Spain	214	Vodafone	01
Spain	214	Orange	03
Spain	214	Movistar	07
Spain	214,214	Orange and Movistar	03,07
UK	234	Vodafone	15
UK	234	Hutchison 3	20
UK	234,234	EE	33,30
UK	234	EE	30
Netherlands	204	KPN	08
Netherlands	204	T-Mobile	16
Netherlands	204	Vodafone	04
Australia	505	Vodafone	03
Australia	505	Optus	02
Australia	505	Telstra	01
Poland	260	Orange	03
Poland	260	T-Mobile	02
Poland	260	Polkomtel (Plus)	01
Canada	302	Rogers	720
Canada	302	Telus	220
Canada	302	Freedom	490
Canada	302	Bell	610
Czech Republic	230	Vodafone	03
Czech Republic	230	T-Mobile	01
Hungary	216	Vodafone	70
Hungary	216	Magyar	30
New Zealand	530	Vodafone	01
New Zealand	530	2degrees	24
Finland	248	Elisa	02
Finland	248	DNA	12

Prerequisites

The enterprise to which the API key belongs must be the same as the enterprise to which the SIM card belongs.

The SIM card status must be "In Service".

The SIM card's current data plan must support this operation. (For details, please consult Linkage support staff.)

Notes

The operation is processed asynchronously. A successful synchronous response from the API indicates that the Linkage system has successfully received the request.

Ways to get the asynchronous processing result:

Use the request_id from the API response header to query the processing result via Query Asynchronous Processing Result.

Obtain the result through a notification API callback (pending).

Before the asynchronous operation is complete, the card will be in a locked state. During this time, operations such as activation, deactivation, reactivation, and reset are prohibited for the same SIM.

The asynchronous process usually completes within a few seconds. However, if anomalies such as network congestion occur in the operator's system, the processing time may extend to tens of minutes or even longer.

If the asynchronous operation fails, the user can initiate the operation again.

SDK API Call Method

Minimum supported SDK version: 1.0.12

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Brief Description#

Version:#

Use Case#

Prerequisites#

Notes#

SDK API Call Method#

Request