Request

The <deleteSubscriberRequest> request removes IMSI and MSISDN routing data and can remove subscriber data. See Subscriber and Routing Data for a description of subscriber and routing data. Each routing entity contains up to eight destination names. Each destination contains FQDN and realm values.

If the group="y" attribute is specified, then the request deletes all data associated with the subscriber. The Account ID, all relationships, and all IMSI and MSISDN routing entities that were assigned to the subscriber are deleted.

If group="y" is not specified or if group="n" is specified, only IMSI and MSISDN routing entities are deleted. If the IMSI or MSISDN value is assigned to a subscriber and there is at least one more IMSI or MSISDN value assigned to the subscriber, then the IMSI or MSISDN value is removed from the subscriber.

Note: The last IMSI or MSISDN value cannot be removed from a subscriber. The user must delete the whole subscriber by specifying the group="y" attribute.

Semantic Rules (requests that do not specify the group attribute or specify group="n")

Semantic Rules (requests that specify group="y")

  • All specified accountId, imsi, or msisdn values must be assigned to the same subscriber. The specified imsi or msisdn values cannot exist in a stand-alone routing entity.
  • The accountId parameter can be specified.
  • At least one accountId, imsi, or msisdn value must be specified.
  • A maximum of six imsi, six msisdn, and one accountId values can be specified.

Request Format

The request must be inserted between the <soapenv:Body> and </soapenv:Body> XML tags, as shown in SOAP Request Messages.
<deleteSubscriberRequest [timeout="timeout"] [group="group"]>
    <addressList>
    [
        <accountId>accountId</accountId>
    ]
    [
    <imsi>imsi</imsi>
        …
    <imsi>imsi</imsi>
    ]
    [
    <msisdn>msisdn</msisdn>
        …
    <msisdn>msisdn</msisdn>
]
    </addressList>
</deleteSubscriberRequest>

Request Parameters

<deleteSubscriberRequest> Parameters (SOAP)
Parameter Description Values
timeout (Optional)

The amount of time (in seconds) to wait before being able to perform a write if another connection is performing a write, or has a transaction open. Clients waiting to write will be processed in the order that their requests were received.

If the request is being performed within a transaction, this parameter will have no effect, as the client already has a transaction open.

0 (return immediately if not available) to 3600 seconds (default is 0).
group (Optional) Indicates if all of the subscriber’s data should be deleted or just specified IMSI or MSISDN routing entities.
  • y - Delete subscriber and all of its IMSI and MSISDN routing entities.
  • n - Only delete specified IMSI and MSISDN routing entities (default).
accountId (Optional) A user-defined Account ID value to delete. 1 to 26 numeric digits.
imsi (Optional) An IMSI (specified in E.212 format) value to delete. 10 to 15 numeric digits.
msisdn (Optional) An MSISDN (specified in E.164 format) value to delete. 8 to 15 numeric digits.