Single Generate AC

# Single Generate AC

Simlessly API (v1.0.0): Single Generate AC

# POST

https://rsp.simlessly.com/api/v2/ac/generate (opens new window)

# Parameters of Request

Name Type MOC Description Example
iccid String Mandatory ICCID (length: 19-20) 89860468152080349618
imsi String Mandatory IMSI (length: 15) 460048867619618
ki String Mandatory KI (32 bits, HEX) 6BE2053E8580B135CD43443380DB7111
opc String Optional OPC(32 bits, HEX) eg: 85304194B0D2A2F92847F1594529F6AA, Can be null when the configuration type is Conformance Test
msidn String Optional MSIDN(15HEX) 8613912345678
hplmnList List(String) Optional HPLMN List(if not provided, the HPLMN from configuration will be used by default) ["45400"]
ehplmnList List(String) Optional EHPLMN List(if not provided, the EHPLMN from configuration will be used by default) ["45400"]
oplmnList List(String) Optional OPLMN List(if not provided, the OPLMN from configuration will be used by default) ["45400"]
fplmnList List(String) Optional FPLMN List(If not provided, the FPLMN from configuration will be used by default) ["45400"]
spn String Optional If not provided, the SPN from configuration will be used by default Simlessly
pnn String Optional If not provided, the PNN from configuration will be used by default Simlessly
impi String Optional IMS Param 260036614799000@ims.mnc006.mcc260.3gppnetwork.org
impu List(String) Optional IMS Param ["sip:260036614799000@ims.mnc006.mcc260.3gppnetwork.org"]
c9 String Optional Applet Param 0C3C0302984D3E05212B9A81FC07992113329595FF0400080520
cc String Optional Confirm Code 1234
ara String Optional ARA E230E122C1204EE8ECC637F98116E35180A47732614D23B3B886317D1A703B917BDD028B8B84E30ADB080000000000000001
expireTime String Optional Applet Param, The format: yyyy-MM-dd HH:mm:ss 2023-03-07 12:00:00
configName String Mandatory Configuration name in Simlessly platform templateRegualr01
encryptionMode Integer Optional Default value is 1 (plaintext) when not filed /
needAcLink Boolean Optional Whether to return Ac Link. Defaults to false. true
pin1 String Optional PIN1 1234
pin2 String Optional PIN2 1234
puk1 String Optional PUK1 61324527
puk2 String Optional PUK2 42905540
adm1 String Optional ADM1 96104791
mccImsiRelations List(MccImsiRelationData) Optional Multi IMSI Data List. Constraint: The maximum size of the list is 11 (can contain up to 11 MultiImsiData elements).
multiImsiDataList List(MultiImsiData) Optional Multi IMSI Data List
smsp String Optional SMSP XXXXX

# MccImsiRelationData

Name Type MOC Description Example
mcc String Mandatory MCC 460
imsiList List(String) Mandatory IMSI List. Constraints: The maximum size of the list is 11 ; the value in the list must be the value of the imsi field in any MultiImsiData element of multiImsiDataList. ["460048867619618"]

# MultiImsiData

Name Type MOC Description Example
imsi String Mandatory IMSI 460048867619618
mncLength Integer Mandatory MNC Length (only 2 or 3 is allowed) 2
plmnList List(PlmnRat) Mandatory PLMN List. Constraint: The maximum size of the list is 20 (can contain up to 20 PlmnRat elements). { "plmn": "45400", "rat": "4000" }
hplmnList List(PlmnRat) Mandatory HPLMN List. Constraint: The maximum size of the list is 10 (can contain up to 10 PlmnRat elements). { "plmn": "45400", "rat": "4000" }
fplmnList List(PlmnRat) Mandatory FPLMN List. Constraint: The maximum size of the list is 4 (can contain up to 4 PlmnRat elements). { "plmn": "45400", "rat": "4000" }
ehplmnList List(PlmnRat) Mandatory EHPLMN List. Constraint: The maximum size of the list is 4 (can contain up to 4 PlmnRat elements). { "plmn": "45400", "rat": "4000" }

# PlmnRat

Name Type MOC Description Example
plmn String Mandatory PLMN 45400
rat String Mandatory RAT 4000

# Example of Request

{
  "iccid": " 89860468152080349618",
  "imsi": " 460048867619618",
  "ki": " 6BE2053E8580B135CD43443380DB7111",
  "opc": " 85304194B0D2A2F92847F1594529F6AA",
  "msidn": " 8613912345678",
  "impi": " 260036614799000@ims.mnc006.mcc260.3gppnetwork.org",
  "impu": [
    "sip:260036614799000@ims.mnc006.mcc260.3gppnetwork.org"
  ],
  "c9": " 0C3C0302984D3E05212B9A81FC07992113329595FF0400080520",
  "cc": " 1234",
  "ara": " E230E122C1204EE8ECC637F98116E35180A47732614D23B3B886317D1A703B917BDD028B8B84E30ADB080000000000000001",
  "expireTime": " 2023-03-07 12:00:00",
  "configName": " templateRegualr01",
  "encryptionMode": 1,
  "needAcLink": true,
  "pin1": "1234",
  "pin2": "1234",
  "puk1": "61324527",
  "puk2": "42905540",
  "adm1": "96104791",
  "mccImsiRelations": [
    {
      "imsiList": [
        "460048867619618",
        "460048867619619",
        "460048867619620"
      ],
      "mcc": "460"
    }
  ],
  "multiImsiDataList": [
    {
      "imsi": "460048867619618",
      "mncLength": 2,
      "plmnList": [
        {
          "plmn": "45400",
          "rat": "4000"
        }
      ],
      "hplmnList": [
        {
          "plmn": "45400",
          "rat": "4000"
        }
      ],
      "fplmnList": [
        {
          "plmn": "45400",
          "rat": "4000"
        }
      ],
      "ehplmnList": [
        {
          "plmn": "45400",
          "rat": "4000"
        }
      ]
    }
  ]
}

# Parameters of Response

Name Type MOC Description Example
iccid String Mandatory ICCID (length: 19-20) 89860468152080349618
activationCode String Optional AC 1$rsp-eu.simlessly.com$CE261FCF57EFCB7C492DD8ECF43C5ADD
acLink String Optional The link address of the QR Code https://static.simlessly.com/simlessly/QR/89852019919010400000.png

# Example of Response

 {
  "obj": {
    "iccid": "89860468152080348700",
    "activationCode": "1$rsp-eu.simlessly.com$CE261FCF57EFCB7C492DD8ECF43C5ADD",
    "acLink": "https://static.simlessly.com/simlessly/QR/89852019919010400000.png"
  },
  "success": true,
  "msg": "",
  "code": "00000"
}