Name
SearchLocalCarrierExpress Retrieve information about a toll-free number's records for a specific carrier.
Description

SearchLocalCarrierExpress provides the ability to retrieve certain information in a toll-free number's carrier-specific records. This includes the date/time of a record plus the carrier-specific features defined for that record. The search is limited to numbers owned by the API user's company. In addition to information about a number's individual records, a count of records is also provided. The following are the allowed fields in reqparams:
* carrier The carrier for which data will be queried. Valid values are:
  • ATT
  • Lumen-5102
  • Sinch
  • Verizon-0222
* dn The toll-free number to be queried.
latestdate Only return information related to the latest record. Setting latestdate to y will retrieve only the latest record. Setting this param to any other value or not specifying it indicates that all records should be returned.

The timeout parameter, available to all API calls, should not be set to less than 30 seconds for this call since this call does not support retrieving data after a timeout occurs.
MGI Messages
None.
Results
The result of a SearchLocalCarrierExpress request is represented as an XML document. This XML document will be contained within the <msgparams> tag of the normal 8MS API return structure. For example, the following might be returned from a request: 
<msgparams>
<SearchLocalCarrierExpress>
<RecordsTotal>1</RecordsTotal>
<Verizon-0222>
<Record>
<Number>855-711-8583</Number>
<RequestDateTime>11/21/11 07:15A</RequestDateTime>
<ResponseDateTime>11/23/11 07:15A</ResponseDateTime>
<Resporg>ART01</Resporg>
<PlanId>1</PlanId>
<CorpId>1</CorpId>
<Record>
<Verizon-0222>
<SearchLocalCarrierExpress>
</msgparams>
Example
The following request parameter will request the record date/time and CIC list for the toll-free number in the Active status:
dn~8005551212;carrier~ATT