Services to retrieve information about subscribers:
The recipient address type may vary depending on the service configuration. The operations team decides how the service will access BiP users before integration. Default access is hashed numbers. For MSISDN access, contact the bipussu super admin.
Send the service username/password in the Header using Basic Authentication.
| Field | Value | Description |
|---|---|---|
| *txnid | string | Request id value |
| Field | Value | Description |
|---|---|---|
| *txnid | string | Request id value |
| *resultcode | string | Response code. 0 for success; otherwise see Error Codes. |
| *list | list | User list |
Example: Encrypted numbers returned in the response.
{
"txnid": "243"
}
{
"resultcode":0,
"list":[
{
"type":0,
"address":"nbVj/RZxGvcn/gdEYJ0MSg=="
},
{
"type":0,
"address":"nxcEoZ0ED1pmBf/SHnlI0g=="
},
{
"type":0,
"address":"DQxvJoHFb7kfJcv6BULl4g=="
}
]
}
Example: Plain numbers returned in the response.
{
"txnid": "243"
}
{
"resultcode":0,
"list":[
{
"type":2,
"address":"9053XXXXXXXX"
},
{
"type":2,
"address":"9053YYYYYYYY"
},
{
"type":2,
"address":"9053ZZZZZZZZ"
}
]
}
{
"txnid": "1245"
}
{
"resultcode": 0,
"followercount": 25
}