1NCE · Schema
1NCE SIM
JSON Schema for a 1NCE SIM resource as returned by /v2/sims/{iccid} on api.1nce.com/management-api. Derived from the 1NCE SIM Management v2 OpenAPI document.
IoTConnectivitySIMCellularNB-IoTLTE-MeUICCEdgeEmbeddedGlobal Roaming
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/1nce/main/json-schema/1nce-sim-schema.json",
"title": "1NCE SIM",
"description": "JSON Schema for a 1NCE SIM resource as returned by /v2/sims/{iccid} on api.1nce.com/management-api. Derived from the 1NCE SIM Management v2 OpenAPI document.",
"$defs": {
"SimsSimQuotaStatus": {
"type": "object",
"title": "Quota Status",
"description": "Indicates whether more than 20%, less than 20% or 0% of the current quota SMS or data are still available.",
"properties": {
"id": {
"type": "number",
"description": "Numeric indicator for the threshold levels: <ul><li>0: more than 20%</li><li>1: less than 20%</li><li>2: 0% remaining</li></ul>",
"example": 0
},
"description": {
"type": "string",
"description": "Text description of the quota status."
},
"threshold_reached_date": {
"type": "string",
"description": "Date on which the threshold less than 20% of the quota avaliable was reached.",
"format": "date-time"
},
"quota_exceeded_date": {
"type": "string",
"description": "Date on which 100% of the avaliable quota was exceeded.",
"format": "date-time"
}
}
},
"SimsSim": {
"type": "object",
"title": "SIM Card",
"description": "Detailed information about a SIM card.",
"properties": {
"iccid": {
"type": "string",
"description": "ICCID identifier of the SIM.",
"example": "8988303000123456789"
},
"iccid_with_luhn": {
"type": "string",
"description": "ICCID identifier of the SIM with Luhn check number.",
"example": "89883030001234567890"
},
"imsi": {
"type": "string",
"description": "First IMSI of the SIM, used for normal 1NCE network.",
"example": "901405100000018"
},
"imsi_2": {
"type": "string",
"description": "Second IMSI of the SIM, used for China+ network.",
"example": "901405100000018"
},
"current_imsi": {
"type": "string",
"description": "Currently active IMSI, dependent on the region where the SIM is used.",
"example": "901405100000018"
},
"msisdn": {
"type": "string",
"description": "MSISDN of the SIM.",
"example": "882285100000018"
},
"imei": {
"type": "string",
"description": "IMEI of the device in which the SIM is inserted.",
"example": "0000000000000018"
},
"imei_lock": {
"type": "boolean",
"description": "Indicates if SIM is locked to the current device IMEI.",
"example": true
},
"status": {
"type": "string",
"description": "The current status of the SIM card.",
"example": "Disabled",
"enum": [
"Enabled",
"Disabled"
]
},
"activation_date": {
"type": "string",
"description": "The date when the SIM card was activated.",
"example": "2018-03-09T07:59:09.000+0000"
},
"ip_address": {
"type": "string",
"description": "The fixed IP address of the SIM card.",
"example": "100.100.100.18"
},
"current_quota": {
"type": "number",
"description": "The overall set data quota for the SIM in MB.",
"example": 500
},
"quota_status": {
"$ref": "#/components/schemas/SimsSimQuotaStatus"
},
"current_quota_SMS": {
"type": "number",
"description": "Current SMS Quota for the SIM.",
"example": 250
},
"quota_status_SMS": {
"$ref": "#/components/schemas/SimsSimQuotaStatus"
},
"label": {
"type": "string",
"description": "Label set by the customer in the 1NCE Portal for the SIM.",
"example": "DX-137-B12"
}
}
},
"NotFound": {
"description": "Not found Error",
"type": "object",
"required": [
"error_code",
"error_token",
"message"
],
"properties": {
"error_code": {
"type": "number",
"example": 1000
},
"error_token": {
"type": "string",
"example": "NotFound"
},
"message": {
"type": "string",
"example": "Element not found",
"description": "Error Message with more details goes here"
}
}
},
"InternalServerError": {
"description": "Internal Server Error",
"type": "object",
"required": [
"error_code",
"error_token",
"message"
],
"properties": {
"error_code": {
"type": "number",
"example": 1000
},
"error_token": {
"type": "string",
"example": "InternalServerError"
},
"message": {
"type": "string",
"example": "Internal Server Error",
"description": "Error Message with more details goes here"
}
}
},
"SimsSimUpdateReq": {
"type": "object",
"title": "SIM Update Request",
"description": "Information about a SIM card based on a SIM update procedure.",
"properties": {
"iccid": {
"type": "string",
"description": "ICCID of the queried SIM.",
"example": "8988280666000000000"
},
"label": {
"type": "string",
"description": "Label of the SIM set by the customer in the 1NCE Portal.",
"example": "DX-137-B12"
},
"imei_lock": {
"type": "boolean",
"description": "Flag that indicates if SIM is locked to the current device IMEI.",
"example": false
},
"status": {
"type": "string",
"description": "Status of the SIM. A SIM can be enabled (active) or disabled (deactivated).",
"example": "Enabled",
"enum": [
"Enabled",
"Disabled"
]
}
}
},
"BadRequest": {
"description": "Validation Error",
"type": "object",
"required": [
"error_code",
"error_token",
"message"
],
"properties": {
"error_code": {
"type": "number",
"example": 1000
},
"error_token": {
"type": "string",
"example": "BadRequest"
},
"message": {
"type": "string",
"example": "Cannot parse parameter per_page as Int: For Input String \"abc\"",
"description": "Error Message with more details goes here"
}
}
},
"Conflict": {
"description": "Conflict HTTP Status 409",
"type": "object",
"required": [
"error_code",
"error_token",
"message"
],
"properties": {
"error_code": {
"type": "number",
"example": 1000
},
"error_token": {
"type": "string",
"example": "Conflict"
},
"message": {
"type": "string",
"example": "Conflicting request",
"description": "Error Message with more details goes here"
}
}
},
"SimsQuotaStatus": {
"type": "object",
"description": "- 0 - \"EXHAUSTED\"\n- 1 - \"ACTIVE\"\n- 2 - \"EXPIRED\"\n",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"example": 0,
"enum": [
0,
1,
2
]
},
"description": {
"type": "string",
"example": "ACTIVE",
"enum": [
"EXHAUSTED",
"ACTIVE",
"EXPIRED"
]
}
},
"example": {
"id": 0,
"description": "ACTIVE"
}
},
"SimsQuota": {
"title": "Sims Quota",
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"minimum": 1,
"example": 1
},
"status": {
"$ref": "#/components/schemas/SimsQuotaStatus"
},
"volume": {
"type": "number",
"format": "double",
"description": "Amount left i.e. still available for use:\n- for SMS: the quantity/number of short messages\n- for Data: the amount of data traffic in megabytes. 1 megabyte = 1024 kilobytes.\n- can be negative\n",
"example": 435.787951
},
"total_volume": {
"type": "number",
"format": "double",
"description": "Initially provisioned volume or (in case the quota was topped up) the remaining volume at that time plus the\nvolume of the topup.\n- for SMS: the quantity/number of short messages\n- for Data: the amount of data traffic in megabytes. 1 megabyte = 1024 kilobytes.\n",
"example": 500
},
"accumulated_total_volume": {
"type": "number",
"format": "double",
"description": "Sum of initially provisioned volume and all topup volumes.\n",
"example": 100
},
"last_volume_added": {
"type": "number",
"format": "double",
"description": "Amount of SMS or data volume which was last purchased for this SIM:\n- for SMS: the quantity/number of short messages\n- for Data: the amount of data traffic in megabytes. 1 megabyte = 1024 kilobytes.\n",
"example": 500
},
"service": {
"type": "string",
"enum": [
"sms",
"data"
],
"example": "data"
},
"threshold_percentage": {
"type": "integer",
"format": "int64",
"minimum": 0,
"maximum": 100,
"description": "Percentage of the [total_volume] for triggering a threshold event. The threshold event is triggered when the remaining volume reaches or falls below this percentage.",
"example": 20
},
"threshold_volume": {
"type": "number",
"format": "double",
"description": "Calculated upon quota creation and upon quota topup as [total_volume] * [threshold_percentage]:\n- for SMS: the quantity/number of short messages\n- for Data: the amount of data traffic in megabytes. 1 megabyte = 1024 kilobytes.\n",
"example": 20
},
"expiry_date": {
"type": "string",
"format": "date-time",
"description": "The date when this current quota will expire.",
"example": "2029-01-01T00:00:00.000Z"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "ISO8601 DateTime",
"example": "2024-08-24T13:13:21Z"
}
}
},
"SimsConnectivityStatus": {
"type": "object",
"description": "The current connectivity status of a SIM.",
"required": [
"description"
],
"properties": {
"description": {
"type": "string",
"example": "ONLINE",
"enum": [
"ONLINE",
"ATTACHED",
"OFFLINE",
"BLOCKED"
]
}
}
},
"SimsDataTrafficLimitState": {
"type": "object",
"description": "Data traffic limit state of the SIM",
"required": [
"description"
],
"properties": {
"description": {
"type": "string",
"example": "NOT_REACHED",
"enum": [
"REACHED",
"NOT_REACHED"
]
}
}
},
"SimsLocation": {
"type": "object",
"required": [
"iccid",
"imsi"
],
"properties": {
"iccid": {
"type": "string",
"description": "ICCID of a specific 1NCE SIM.",
"example": "8988303010000000000"
},
"imsi": {
"type": "string",
"description": "IMSI of the SIM that triggered the event.",
"example": "901439999999999"
},
"last_updated": {
"type": "string",
"description": "Timestamp from the last location update.",
"example": "2023-08-06 09:59:05"
},
"sgsn_number": {
"type": "string",
"description": "Serving GPRS Support Node (SGSN) identifier for the SGSN where the SIM is attached.",
"example": "120631.mmecd7.mmegi8002.mme.epc.mnc260.mcc310.3gppnetwork.org"
},
"vlr_number": {
"type": "string",
"description": "Visitor Location Register (VLR) identifier.",
"example": "15622751137"
},
"operator_id": {
"type": "string",
"description": "Identifier for the current operator the SIM is connected to.",
"example": "826"
},
"msc": {
"type": "string",
"description": "Mobile-services Switching Centre (MSC) identifier number.",
"example": "491770940000"
},
"sgsn_ip_address": {
"type": "string",
"description": "IP address of the used Serving GPRS Support Node (SGSN).",
"example": "12.23.107.88"
},
"mme_name": {
"type": "string",
"example": "mmeName"
},
"mme_realm": {
"type": "string",
"example": "mmeRealm"
},
"sgsn_name": {
"type": "string",
"example": "sgsnName"
},
"sgsn_realm": {
"type": "string",
"example": "sgsnRealm"
},
"operator": {
"type": "object",
"required": [
"id",
"name",
"country",
"mnc"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1,
"example": 2,
"description": "Identifier for the operator."
},
"name": {
"type": "string",
"example": "T-Mobile",
"description": "String name of the operator where the SIM is currently attached to."
},
"mnc": {
"type": "string",
"example": "01",
"description": "Represents Mobile Network code"
},
"country": {
"type": "object",
"required": [
"id",
"name",
"iso_code"
],
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"example": 74,
"description": "The Country's id. 0 represents the \"ANY\"-country."
},
"name": {
"type": "string",
"example": "Germany",
"description": "String name of the country of the operator where the SIM is currently attached."
},
"iso_code": {
"type": "string",
"description": "ISO code for the country.",
"example": "de"
}
}
}
}
},
"country": {
"type": "object",
"description": "Represents a Country.",
"required": [
"country_id",
"name",
"country_code",
"mcc",
"iso_code"
],
"properties": {
"country_id": {
"type": "string",
"example": "74",
"description": "The Country's id. 0 represents the \"ANY\"-country."
},
"name": {
"type": "string",
"example": "Germany",
"description": "String name of the country where the SIM device is currently located."
},
"country_code": {
"example": "49",
"type": "string",
"description": "The international phone number prefix. \u201c49\u201d is the one for Germany, \u201c381\u201d is the one for Serbia."
},
"mcc": {
"type": "string",
"example": "262",
"description": "An MCC (Mobile Country Code) is used in combination with an MNC (a combination known as an \"MCC/MNC tuple\") to uniquely identify a mobile network operator (carrier) using the GSM (including GSM-R), UMTS, LTE, and 5G public land mobile networks."
},
"iso_code": {
"type": "string",
"example": "de",
"description": "The ISO 3166 code."
}
}
}
}
},
"SimsPdpContext": {
"type": "object",
"required": [
"pdp_context_id",
"endpoint_id",
"tariff_id",
"ratezone_id",
"organisation_id",
"tx_teid_data_plane",
"tx_teid_control_plane",
"rx_teid",
"rx_teid_data_plane",
"rx_teid_control_plane",
"gtp_version",
"nsapi",
"sgsn_control_plane_ip_address",
"sgsn_data_plane_ip_address",
"ggsn_control_plane_ip_address",
"ggsn_data_plane_ip_address",
"created",
"mcc",
"mnc",
"lac",
"ci",
"sac",
"rac",
"ue_ip_address",
"imeisv",
"rat_type",
"region",
"apn",
"sim_id",
"imsi_id",
"imsi"
],
"properties": {
"pdp_context_id": {
"type": "string",
"description": "ID of the current PDP Context.",
"example": "92415"
},
"endpoint_id": {
"type": "string",
"description": "ID of the used SIM endpoint.",
"example": "166"
},
"tariff_id": {
"type": "string",
"description": "ID of the used tariff.",
"example": "34"
},
"ratezone_id": {
"type": "string",
"description": "ID of the used ratezone.",
"example": "70"
},
"organisation_id": {
"type": "string",
"description": "ID of the internal organisation reference.",
"example": "2"
},
"imsi_id": {
"type": "string",
"description": "ID of the used IMSI.",
"example": "627"
},
"imsi": {
"type": "string",
"description": "IMSI of the specific SIM.",
"example": "901439999999999"
},
"sim_id": {
"type": "string",
"description": "ID of the specific SIM.",
"example": "625"
},
"tx_teid_data_plane": {
"type": "string",
"description": "Tunnel ID for the current PDP Context user plane.",
"example": "7116"
},
"tx_teid_control_plane": {
"type": "string",
"description": "Tunnel ID for the current PDP Context control plane.",
"example": "7116"
},
"rx_teid": {
"type": "string",
"example": "7116"
},
"rx_teid_data_plane": {
"type": "string",
"example": "7116"
},
"rx_teid_control_plane": {
"type": "string",
"example": "7116"
},
"gtp_version": {
"type": "string",
"description": "Version of the used GPRS Tunneling Protocol (GTP).",
"example": "1"
},
"nsapi": {
"type": "string",
"description": "ID of the used Network Service Access Point Identifier (NSAPI).",
"example": "5"
},
"sgsn_control_plane_ip_address": {
"type": "string",
"example": "12.23.107.89",
"description": "IP address of the Serving GPRS Support Node (SGSN) for the control plane."
},
"sgsn_data_plane_ip_address": {
"type": "string",
"example": "12.23.107.89",
"description": "IP address of the Serving GPRS Support Node (SGSN) for the user data plane."
},
"ggsn_control_plane_ip_address": {
"type": "string",
"example": "12.23.107.89",
"description": "IP address of the Gateway GPRS Support Node (GGSN) for the control plane."
},
"ggsn_data_plane_ip_address": {
"type": "string",
"example": "12.23.107.89",
"description": "IP address of the Gateway GPRS Support Node (GGSN) for the user data plane."
},
"created": {
"type": "string",
"example": "2019-12-04T08:12:02.000Z",
"description": "Timestamp when the PDP Context was created."
},
"mcc": {
"type": "string",
"example": "262",
"description": "Mobile Country Code (MCC)."
},
"mnc": {
"type": "string",
"example": "01",
"description": "Mobile Network Code (MNC)."
},
"operator_id": {
"type": "string",
"example": "4"
},
"lac": {
"type": "string",
"example": "40217",
"deprecated": true,
"description": "**Deprecated**. Use `gtp_v1_uli.lac` instead.\n"
},
"ci": {
"type": "string",
"example": "12",
"deprecated": true,
"description": "**Deprecated**. Use `gtp_v1_uli.ci` instead.\n"
},
"sac": {
"type": "string",
"example": "7",
"deprecated": true,
"description": "**Deprecated**. Use `gtp_v1_uli.sac` instead.\n"
},
"rac": {
"type": "string",
"example": "8",
"deprecated": true,
"description": "**Deprecated**. Use `gtp_v1_uli.rac` instead.\n"
},
"gtp_v1_uli": {
"type": "object",
"description": "GTP V1 User Location Information. Cannot be returned with both gtp_v1_uli and gtp_v2_uli. Only one is returned.",
"properties": {
"lac": {
"type": "string",
"description": "Location Area Code",
"example": "40217"
},
"ci": {
"type": "string",
"description": "Cell ID",
"example": "12"
},
"sac": {
"type": "string",
"description": "Service Area Code",
"example": "7"
},
"rac": {
"type": "string",
"description": "Routing Area Code",
"example": "8"
}
}
},
"gtp_v2_uli": {
"type": "object",
"description": "GTP V2 User Location Information. Cannot be returned with both gtp_v1_uli and gtp_v2_uli. Only one is returned.",
"properties": {
"cgi": {
"type": "object",
"description": "Cell Global Identification",
"properties": {
"lac": {
"type": "string",
"description": "Location Area Code",
"example": "40217"
},
"ci": {
"type": "string",
"description": "Cell ID",
"example": "12"
}
}
},
"sai": {
"type": "object",
"description": "Service Area Identity",
"properties": {
"lac": {
"type": "string",
"description": "Location Area Code",
"example": "40217"
},
"sac": {
"type": "string",
"description": "Service Area Code",
"example": "7"
}
}
},
"rai": {
"type": "object",
"description": "Routing Area Identity",
"properties": {
"lac": {
"type": "string",
"description": "Location Area Code",
"example": "40217"
},
"rac": {
"type": "string",
"description": "Routing Area Code",
"example": "8"
}
}
},
"tac": {
"type": "string",
"description": "Tracking Area Code",
"example": "38402"
},
"eci": {
"type": "string",
"description": "E-UTRAN Cell Identifier",
"example": "12"
},
"lac": {
"type": "string",
"description": "Location Area Code",
"example": "40217"
},
"menbi": {
"type": "string",
"description": "Macro eNodeB ID",
"example": "88364"
},
"emenbi": {
"type": "string",
"description": "Extended Macro eNodeB ID",
"example": "4"
}
}
},
"ue_ip_address": {
"type": "string",
"example": "10.199.5.223",
"description": "IP address of the device using the SIM."
},
"imeisv": {
"type": "string",
"example": "3526510721968301",
"description": "IMEISV of the device with the SIM."
},
"rat_type": {
"type": "object",
"description": "Describes the Radio Access Technology used in the PDP Context.",
"required": [
"rat_type_id",
"description"
],
"properties": {
"rat_type_id": {
"type": "string",
"example": "2",
"description": "ID of the used RAT."
},
"description": {
"type": "string",
"example": "NB-IoT",
"description": "Radio Access Type name"
}
}
},
"region": {
"type": "string",
"example": "us-east-1"
},
"apn": {
"type": "string",
"example": "apn"
},
"ipcan_session_id": {
"type": "string",
"example": "23"
}
},
"description": "Information about the current PDP Context of the SIM."
},
"SimsConnectivityDetail": {
"type": "object",
"description": "Information about the current SIM connectivity status, location and PDP Context of a SIM.",
"required": [
"status",
"services"
],
"properties": {
"status": {
"$ref": "#/components/schemas/SimsConnectivityStatus"
},
"data_traffic_limit_state": {
"$ref": "#/components/schemas/SimsDataTrafficLimitState"
},
"location": {
"$ref": "#/components/schemas/SimsLocation"
},
"pdp_contexts": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SimsPdpContext"
}
},
"services": {
"type": "array",
"description": "List of services currently available.",
"items": {
"type": "string",
"description": "Currently used service.",
"example": "GPRS"
}
}
}
},
"SimsSms": {
"type": "object",
"properties": {
"submit_date": {
"type": "string",
"format": "date-time",
"example": "2019-09-29T07:33:15.000Z"
},
"delivery_date": {
"type": "string",
"format": "date-time",
"example": "2019-09-29T07:33:15.000Z"
},
"expiry_date": {
"type": "string",
"format": "date-time",
"example": "2019-09-30T07:33:15.000Z"
},
"final_date": {
"type": "string",
"format": "date-time",
"example": "2019-09-29T07:33:18.000Z"
},
"retry_date": {
"type": "string",
"format": "date-time",
"nullable": true,
"example": null
},
"last_delivery_attempt": {
"type": "string",
"format": "date-time",
"example": "2019-09-29T07:33:15.000Z"
},
"retry_count": {
"type": "integer",
"format": "int64",
"example": 0
},
"gsm_map_error": {
"type": "string",
"nullable": true,
"example": null
},
"dcs": {
"type": "integer",
"format": "int64",
"example": 0
},
"pid": {
"type": "integer",
"format": "int64",
"example": 0
},
"source_address": {
"type": "string",
"example": "1234"
},
"endpoint": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"example": 166
},
"name": {
"type": "string",
"example": "Your Endpoint"
}
}
},
"sim_id": {
"type": "integer",
"format": "int64",
"example": 0
},
"iccid": {
"type": "string",
"example": "8988303000000001000"
},
"msisdn": {
"type": "string",
"example": "883XXXXXXXXXXXX"
},
"imsi": {
"type": "string",
"example": "901XXXXXXXXXXXX"
},
"msc": {
"type": "integer",
"format": "int64",
"example": 491770940000
},
"udh": {
"type": "string",
"example": ""
},
"payload": {
"type": "string",
"example": "***"
},
"id": {
"type": "integer",
"format": "int64",
"example": 589
},
"status": {
"type": "object",
"description": "4 - DELIVERED\n\n5 - FAILED\n\n2 - PENDING\n\n6 - EXPIRED\n",
"properties": {
"description": {
"type": "string",
"enum": [
"DELIVERED",
"FAILED",
"PENDING",
"EXPIRED"
]
},
"id": {
"type": "integer",
"format": "int64",
"enum": [
4,
5,
2,
6
]
}
}
},
"sms_type": {
"type": "object",
"description": "1 - MT\n\n2 - MO\n",
"properties": {
"description": {
"type": "string",
"enum": [
"MT",
"MO"
]
},
"id": {
"type": "integer",
"format": "int64",
"enum": [
1,
2
]
}
}
},
"source_address_type": {
"type": "object",
"properties": {
"description": {
"type": "string",
"example": "National"
},
"id": {
"type": "integer",
"format": "int64",
"example": 161
}
}
}
}
},
"SMSSourceAddressType": {
"title": "Source Address Type",
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "Numerical identifier for the type of source address of an SMS. <ul><li>145 - International</li><li>161 - National</li><li>208 - Alphanumeric</li></ul>",
"example": 145,
"enum": [
145,
161,
208
]
}
}
},
"SMSMessage": {
"title": "SMS Message Object",
"description": "SMS message object used to describe an SMS message.",
"type": "object",
"properties": {
"source_address": {
"type": "string",
# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/1nce/refs/heads/main/json-schema/1nce-sim-schema.json