Name
NumberHistory Retrieve the change history of a number.
Description
SMS/800 maintains a database of the change history of all toll free numbers. Any time a change is made, an entry is made noting the date/time of the change, the login ID used to make the change, a RespOrg change that may have resulted, and/or a change to the status of the number. The information in the SMS history database is updated nightly. Thus, a change may take up to a day to be reflected in the history database.

NumberHistory provides a means to access this information via the 8MS API. The following are the allowed fields in reqparams:
* dn The number to be queried.

MGI Messages
None.
Results
The result of a NumberHistory request (i.e., the change history of the given number) is represented as an XML document. This XML document will be contained with the <reqparams> tag of the normal 8MS API return structure. For example, the following might be returned from a history request: 
<API8MS>
<reqid>OA03743771</reqid>
<message>
<routeid></routeid>
<termrpt>COMPLD</termrpt>
<errorcd>0</errorcd>
<reqparams>
<history dn="8666006000">
 <change>
   <change-date>05/29/2003 10:50:09</change-date>
   <status>WORKING</status>
   <status-change-date>07/29/2000 18:23:31</status-change-date>
   <resporg>ART10</resporg>
   <prev-resporg>ART01</prev-resporg>
   <logon-id>ART01000</logon-id>
   <download-date>05/30/2003 00:01:00</download-date>
 </change>
 <change>
   <change-date>07/29/2000 18:23:31</change-date>
   <status>WORKING</status>
   <status-change-date>07/29/2000 18:23:31</status-change-date>
   <resporg>ART01</resporg>
   <prev-resporg>     </prev-resporg>
   <logon-id>ART01000</logon-id>
   <download-date>03/28/2002 12:56:29</download-date>
 </change>
 <change>
   <change-date>07/29/2000 18:23:27</change-date>
   <status>ASSIGNE</status>
   <status-change-date>07/29/2000 18:23:27</status-change-date>
   <resporg>ART01</resporg>
   <prev-resporg>     </prev-resporg>
   <logon-id>ART01000</logon-id>
   <download-date>03/12/2002 21:14:26</download-date>
 </change>
 <change>
   <change-date>07/29/2000 12:01:25</change-date>
   <status>RESERVE</status>
   <status-change-date>07/29/2000 12:01:25</status-change-date>
   <resporg>ART01</resporg>
   <prev-resporg>     </prev-resporg>
   <logon-id>ART01000</logon-id>
   <download-date>03/12/2002 21:14:04</download-date>
 </change>
</history>

</reqparams>
</message>
</API8MS>
Each <change> within the <history> consists of the following:
change-date the date/time of the change
status the number status at that point in time
status-change-date the date/time the number attained the given status
resporg the controlling resporg of the number at that time
prev-resporg the previous resporg (if the associated change included a resporg change)
logon-id the SMS800 logon ID used to make the change
download-date the date/time that the change record was retrieved from the main SMS/800 DB
Example
The following request parameter will request the history for the number 8005551212:
dn~8005551212