Request

The <readSubscriberRequest> request extracts IMSI and MSISDN routing data and subscriber data. See Subscriber and Routing Data for a description of subscriber and routing data. Each routing entity contains up to eight destination names.

If the group="y" attribute is specified, then the request extracts and displays all data associated with the subscriber. The returned response will have the Subscriber's Account ID, all IMSI and MSISDN values, and the eight destination values from any of the subscriber's routing entities is returned in the response. All of a subscriber's routing entities have the same destination values, so any routing entity can be used to extract the values.

If group="y" is not specified or if group="n" is specified, then only the specified IMSI and MSISDN routing entities are retrieved. The returned response will have each IMSI or MSISDN value along with its individual up to eight destination values.

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

The accountId parameter cannot be specified.
At least one routing entity (IMSI or MSISDN) must be specified.
A maximum of 10 routing entities (IMSI, MSISDN, or combinations of the two) can be specified.

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

All specified accountId, imsi, or msisdn values must be assigned to one subscriber. The specified IMSI and MSISDN values cannot exist in a stand-alone routing entity.
The accountId parameter can 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.

<readSubscriberRequest [group="group"]>
    <addressList>
    [
        <accountId>accountId</accountId>
    ]
    [
    <imsi>imsi</imsi>
        …
    <imsi>imsi</imsi>
    ]
    [
    <msisdn>msisdn</msisdn>
        …
    <msisdn>msisdn</msisdn>
]
    </addressList>
</readSubscriberRequest>

Request Parameters

<readSubscriberRequest> Parameters (SOAP)
Parameter	Description	Values
group (Optional)	Indicates if all of the subscriber’s data should be retrieved or just specified IMSI or MSISDN routing entities.	y - Read subscriber and all of its IMSI and MSISDN routing entities. n - Only read specified MSISDN and IMSI routing entities (default).
accountId (Optional)	A user-defined Account ID value to read.	1 to 26 numeric digits.
imsi (Optional)	An IMSI (specified in E.212 format) value to read.	10 to 15 numeric digits.
msisdn (Optional)	An MSISDN (specified in E.164 format) value to read.	8 to 15 numeric digits.