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

Properties

Name Type Description
iccid string ICCID identifier of the SIM.
iccid_with_luhn string ICCID identifier of the SIM with Luhn check number.
imsi string First IMSI of the SIM, used for normal 1NCE network.
imsi_2 string Second IMSI of the SIM, used for China+ network.
current_imsi string Currently active IMSI, dependent on the region where the SIM is used.
msisdn string MSISDN of the SIM.
imei string IMEI of the device in which the SIM is inserted.
imei_lock boolean Indicates if SIM is locked to the current device IMEI.
status string The current status of the SIM card.
activation_date string The date when the SIM card was activated.
ip_address string The fixed IP address of the SIM card.
current_quota number The overall set data quota for the SIM in MB.
quota_status object
current_quota_SMS number Current SMS Quota for the SIM.
quota_status_SMS object
label string Label set by the customer in the 1NCE Portal for the SIM.
View JSON Schema on GitHub

JSON Schema

1nce-sim-schema.json Raw ↑
{
  "$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://artifacts.apis.io/1nce/json-schema/1nce-sim-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/1nce-sim"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.