Web Service - Methods - GetSubscribers
GetSubscribers
Please note that to use this method, you must have first set up your number to forward inbound messages to the subscription list application.
This method is used to retrieve the phone numbers of subscribers to your specified long inbound number or short code number service.
The number parameter should be set to either a long inbound number (formatted in full international format) or a short code number (configured in local format).
If the service is hosted on a number (long or short) without the use of a keyword, then the keyword parameter should be left blank.
You can choose to receive the return code data from this method as either a CSV string or XML through your setting of the returnCSVString parameter.
If a CSV string is requested, the first line will contain the Transaction code contained within the '#' characters.
On successful completion of this method, the phone numbers of the subscribers to the specified service are returned.
Return Data
Shortcode
XML:
<GetSubscribersResponse>
<Transaction>
<Code>1</Code>
<Description>Transaction OK</Description>
</Transaction>
<Subscribers>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>13:15:17</Time>
<Body>hello world </Body>
<Network>Orange</Network>
<RBID>843822651</RBID>
</Subscriber>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>15:17:13</Time>
<Body>helloworld</Body>
<Network>Orange</Network>
<RBID>843822652</RBID>
</Subscriber>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>17:13:15</Time>
<Body>hello,world</Body>
<Network>Orange</Network>
<RBID>843822653</RBID>
</Subscriber>
</Subscribers>
</GetSubscribersResponse>
CSV:
"+447980123456","+447980123456","","2009-06-03","13:15:17","hello world","Orange","843822651"
"+447980123456","+447980123456","","2009-06-03","15:17:13","helloworld","Orange","843822652"
"+447980123456","+447980123456","","2009-06-03","17:13:15","hello,world","Orange","843822653"
Long Number
XML:
<GetSubscribersResponse>
<Transaction>
<Code>1</Code>
<Description>Transaction OK</Description>
</Transaction>
<Subscribers>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>13:15:17</Time>
<Body>hello world </Body>
<Network>Orange</Network>
</Subscriber>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>15:17:13</Time>
<Body>helloworld</Body>
<Network>Orange</Network>
</Subscriber>
<Subscriber>
<Originator>+447980123456</Originator>
<Destination>+447980123456</Destination>
<Keyword />
<Date>2009-06-03</Date>
<Time>17:13:15</Time>
<Body>hello,world</Body>
<Network>Orange</Network>
</Subscriber>
</Subscribers>
</GetSubscribersResponse>
CSV:
#1# "+447980123456","+447980123456","","2009-06-03","13:15:17","hello world","Orange"
"+447980123456","+447980123456","","2009-06-03","15:17:13","helloworld","Orange"
"+447980123456","+447980123456","","2009-06-03","17:13:15","hello,world","Orange"