REST API‎ > ‎Registration‎ > ‎

Change Registered Phone Number

This method changes the phone number associated with a previously-registered networkid.

This is in case the user ever wants to change their phone number in Telesocial -- a customer service feature that may or may not apply to you and your app (it's a nice to have for your users).


Method: POST

URI: /api/rest/registrant/{networkid}/{phone}

Form parameters:
  • appkey The application key of the application.
Path parameters:
  • networkid The network ID to be changed
  • phone The phone number that the networkid will become associated with.
Query parameters: None

Returns:
ACCEPTED(202)The request was accepted.
BAD_REQUEST(400)One or more parameters were invalid or this (phone, networkid) pair is already registered.
UNAUTHORIZED(401) The networkid is not associated with the specified application.
BAD_GATEWAY(502)Unable to start the phone authorization process.

Response format: JSON

Example:

curl -d"appkey=1f1bbca5-b71f-4138-97b6-59fed80623bc" https://api.bitmouth.com/api/rest/registrant/1000022816599/14054441212

Response body

{"RegistrationResponse":{"message":"","status":202,"uri":""}}


PHP Examples


 public function changePhone($networkID, $phone = false)
    {
        if ($phone{0} != '1')
        {
            $phone = '1' . $phone;
        }
        $query = new bitmouthQuery('registrant', $networkID . '/' . $phone);
        $query->addApiKey();

        if ($query->make())
        {
            return $query->response['status'] == 202;
        }

        return false;
    }