Care Order Request

The storeOrderRequest API enables the client to place orders to modify existing AT&T service.  This includes Adding and Removing Features, Updating Subscriber and Device information, Changing a Rate Plan or Wireless Number (CTN), Suspending and Reinstating Service, Cancelling and Resuming Service, Swapping a SIM, and Resetting Voicemail Passwords. 

Care Order Requests define devices by matching a Customer Telephone Number (CTN) with the device IMEI number associated with it. For a Care Order to succeed, the CTN must be associated with the Device's IMEI, and any Rate Plan, Data Plan, or Feature in the Request must be compatible with the Device.

To find the CTN and IMEI numbers for an account, you can submit a Care Account Information Request.

To find information about compatible Rate Plans, Data Plans, and Features, you can consult the Customer Catalog.

Use Cases

Add or Remove Features

Suppose your employee would like to Add or Remove a Feature from their existing Customer Telephone Number (CTN) and Device.  To use the careOrderRequest to Add or Remove Features, set changeRequest/Type to "updateFeatures". You can also use this option to Add or Change a Data Plan for a device. 

Update Subscriber

Suppose your employee would like to change the Contact Information (i.e. Name, Address, Email Address) associated with their Customer Telephone Number (CTN) and Device.  To use the careOrderRequest to change the details of a subscriber assigned to a CTN and Device, set changeRequest/Type to "updateSubscriber".

Update Device

Suppose your employee would like to associate a new Device with an existing Customer Telephone Number (CTN).  To use the careOrderRequest to assign a CTN to a new Device, set changeRequest/Type to "updateDevice".

Change Rate Plan

Suppose your employee would like to change the Rate Plan associated with their Wireless Number (CTN) and Device.  To use the careOrderRequest to change the Rate Plan, set changeRequest/Type to "changeRatePlan".

Suspend or Reinstate Service

Suppose your employee would like to temporarily Suspend Service to a Customer Telephone Number (CTN) or Reinstate Service that was previously suspended.  To use the careOrderRequest to Suspend Service, set changeRequest/Type to "suspendService".  To Reinstate Service to a CTN set changeRequest/Type to "reinstateService".

Cancel or Resume Service

Suppose your employee would like to Cancel Service or Resume Service to a previously cancelled Customer Telephone Number (CTN).  To use the careOrderRequest to Cancel Service to a CTN, set changeRequest/Type to "cancelService". In order to be Cancelled, the service must have been active for at least 30 days. To use the careOrderRequest to Resume Service to a previously cancelled CTN, set changeRequest/Type to "resumeFromCancel". You can Resume service within 30 days of a request to Cancel Service.

Swap SIM Card

Suppose your employee would like to associate a new SIM with a Customer Telephone Number (CTN) and its Device.  To use the careOrderRequest to assign a new SIM/eSim to a CTN and Device, set changeRequest/Type to "activateSIM".

Change CTN

Suppose your employee would like to change the Customer Telephone Number (CTN) associated with their device.  To use the careOrderRequest to request a new CTN, set changeRequest/Type to "changeCTN". When the request is complete, you will receive the new CTN as part of the Completion Status and in an email.

Care Account Information Request

Suppose your company administrator would like Account Details for a Customer Telephone Number (CTN), including Device IMEI Number, SIM Card ID, and Rate Plan information.  You can use the careAccountRequest to obtain this information for a specific CTN.

Note: AT&T eBonding does not support AT&T Next pricing or Mobile Share plans.