Generate AC By UPP

# Generate AC By UPP

# Overview

Generate an Activation Code (AC) for eSIM profile using Universal Profile Package (UPP). This API is part of the RSP (Remote SIM Provisioning) system.

# API Information

  • Environment: Production
  • Base URL: https://rsp.simlessly.com/api/v1
  • Endpoint: POST /ac/generateByUpp
  • Content-Type: application/json

# Request

# Request Parameters

Parameter Type Required Description Validation Rules Example
iccid String Yes Integrated Circuit Card Identifier Length: 19-20 characters, Numeric only 89860468152080349618
imsi String Yes International Mobile Subscriber Identity Length: 15 characters, Numeric only 460000000000001
upp String Yes Universal Profile Package text Base64 encoded, Valid UPP format A05A800102810103821A536D6172744F7074...
configName String Yes Configuration name for profile Non-empty string DEFAULT_CONFIG
spn String No Service Provider Name Max length: 32 characters Example SPN
araType String No Access Rule Application Type Enum: ["SHA1", "SHA256"] SHA256
ara String No Access Rule Application Valid ARA format ara-value
gid1 String No Group Identifier 1 Hexadecimal string A1B2C3
gid2 String No Group Identifier 2 Hexadecimal string D4E5F6
tk String No UPP Text Encryption Key Index Valid key index format key-index-1
customAcAddress String No Custom Domain Name for AC Valid domain name format custom.example.com
profileName String No Profile Name Max length: 64 characters My_Profile_1
reGenerate Boolean No Force regeneration of existing AC Default: false true

# Example Request

{
  "iccid": "8985211116317800004",
  "imsi": "460000000000001",
  "upp": "A05A800102810103821A536D6172744F7074...",
  "configName": "DEFAULT_CONFIG",
  "spn": "Example SPN",
  "araType": "SHA256",
  "ara": "ara-value",
  "gid1": "A1B2C3",
  "gid2": "D4E5F6",
  "tk": "key-index-1",
  "customAcAddress": "custom.example.com",
  "profileName": "My_Profile_1",
  "reGenerate": true
}

# Response

# Response Parameters

Name Type Required Description Example
success Boolean Yes Operation result status true
code String Yes Response status code 00000
msg String Yes Response message Success
obj.iccid String Yes ICCID of the generated AC 89860468152080349618
obj.activationCode String Yes Generated activation code 1$rsp-eu.simlessly.com$ASFASFAFAFSAFAFSAFFSA

# Success Response Example

{
  "success": true,
  "code": "00000",
  "msg": "",
  "obj": {
    "iccid": "8985211116317800004",
    "activationCode": "1$rsp-eu.simlessly.com$ASFASFAFAFSAFAFSAFFSA"
  }
}

# Error Response Example

{
  "success": false,
  "code": "E0001",
  "msg": "Invalid ICCID format",
  "obj": null
}

Upload Profile Secret >