POST api/list/bulkBusinessSearch?trackingId={trackingId}

Bulk Business Search

Request Information

URI Parameters

Name	Description	Type	Additional information
trackingId	An ID supplied by the client to track or name this request	string	Required

Body Parameters

Business and Building information to match to

BulkBusinessSearchRequestRequestBusinessCandidateList

Name	Description	Type	Additional information
RequestBusinessCandidate		Collection of BulkBusinessSearchRequestRequestBusinessCandidateListRequestBusinessCandidate	None.
Count		string	None.

Request Formats

application/json, text/json

Sample:

{
  "requestBusinessCandidate": [
    {
      "requestAddress": {
        "address": "sample string 1",
        "aptSuiteOther": "sample string 2",
        "city": "sample string 3",
        "state": "Item",
        "stateSpecified": true,
        "zipCode": "sample string 5",
        "preferenceName": "sample string 6"
      },
      "buildingKey": 1,
      "buildingKeySpecified": true,
      "businessName": "sample string 3",
      "contactName": "sample string 4",
      "suite": "sample string 5",
      "phone": "sample string 6",
      "emailAddress": "sample string 7",
      "clientBusinessKey": "sample string 8"
    },
    {
      "requestAddress": {
        "address": "sample string 1",
        "aptSuiteOther": "sample string 2",
        "city": "sample string 3",
        "state": "Item",
        "stateSpecified": true,
        "zipCode": "sample string 5",
        "preferenceName": "sample string 6"
      },
      "buildingKey": 1,
      "buildingKeySpecified": true,
      "businessName": "sample string 3",
      "contactName": "sample string 4",
      "suite": "sample string 5",
      "phone": "sample string 6",
      "emailAddress": "sample string 7",
      "clientBusinessKey": "sample string 8"
    }
  ],
  "count": "sample string 1"
}

application/xml, text/xml

Sample:

<BulkBusinessSearchRequestRequestBusinessCandidateList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Twc.MidasWebServices">
  <countField>sample string 1</countField>
  <requestBusinessCandidateField>
    <BulkBusinessSearchRequestRequestBusinessCandidateListRequestBusinessCandidate>
      <buildingKeyField>1</buildingKeyField>
      <buildingKeyFieldSpecified>true</buildingKeyFieldSpecified>
      <businessNameField>sample string 3</businessNameField>
      <clientBusinessKeyField>sample string 8</clientBusinessKeyField>
      <contactNameField>sample string 4</contactNameField>
      <emailAddressField>sample string 7</emailAddressField>
      <phoneField>sample string 6</phoneField>
      <requestAddressField>
        <addressField>sample string 1</addressField>
        <aptSuiteOtherField>sample string 2</aptSuiteOtherField>
        <cityField>sample string 3</cityField>
        <preferenceNameField>sample string 6</preferenceNameField>
        <stateField>Item</stateField>
        <stateFieldSpecified>true</stateFieldSpecified>
        <zIPCodeField>sample string 5</zIPCodeField>
      </requestAddressField>
      <suiteField>sample string 5</suiteField>
    </BulkBusinessSearchRequestRequestBusinessCandidateListRequestBusinessCandidate>
    <BulkBusinessSearchRequestRequestBusinessCandidateListRequestBusinessCandidate>
      <buildingKeyField>1</buildingKeyField>
      <buildingKeyFieldSpecified>true</buildingKeyFieldSpecified>
      <businessNameField>sample string 3</businessNameField>
      <clientBusinessKeyField>sample string 8</clientBusinessKeyField>
      <contactNameField>sample string 4</contactNameField>
      <emailAddressField>sample string 7</emailAddressField>
      <phoneField>sample string 6</phoneField>
      <requestAddressField>
        <addressField>sample string 1</addressField>
        <aptSuiteOtherField>sample string 2</aptSuiteOtherField>
        <cityField>sample string 3</cityField>
        <preferenceNameField>sample string 6</preferenceNameField>
        <stateField>Item</stateField>
        <stateFieldSpecified>true</stateFieldSpecified>
        <zIPCodeField>sample string 5</zIPCodeField>
      </requestAddressField>
      <suiteField>sample string 5</suiteField>
    </BulkBusinessSearchRequestRequestBusinessCandidateListRequestBusinessCandidate>
  </requestBusinessCandidateField>
</BulkBusinessSearchRequestRequestBusinessCandidateList>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

success

BulkBusinessSearchResponse

Name	Type	Additional information
TrackingID	string	None.
BusinessCandidateList	BusinessCandidateList	None.
ServiceReturnStatus	ServiceReturnStatus	None.

Response Formats

application/json, text/json

Sample:

{
  "trackingID": "sample string 1",
  "businessCandidateList": {
    "businessCandidate": [
      {
        "address": "sample string 1",
        "city": "sample string 2",
        "state": "Item",
        "stateSpecified": true,
        "zipCode": "sample string 4",
        "businessMatchDetail": {
          "businessKey": 1,
          "businessKeySpecified": true,
          "businessName": "sample string 3",
          "buildingKey": 4,
          "buildingKeySpecified": true,
          "buildingAddress": {
            "buildingName": "sample string 1",
            "address": "sample string 2",
            "city": "sample string 3",
            "state": "Item",
            "stateSpecified": true,
            "zipCode": "sample string 5"
          },
          "billingDescriptors": {
            "billingInstanceName": "sample string 1",
            "billingInstanceKey": 2,
            "billingInstanceKeySpecified": true,
            "billingSystemTypeIndicator": "sample string 4",
            "billingSiteID": 5,
            "billingSiteIDSpecified": true,
            "franchiseCode": {
              "fullFranchiseCode": "sample string 1",
              "csg": {
                "sys": "sample string 1",
                "prin": "sample string 2",
                "agent": "sample string 3"
              },
              "icoms": {
                "siteID": "sample string 1",
                "company": "sample string 2",
                "division": "sample string 3",
                "franchiseArea": "sample string 4"
              }
            },
            "legacyMSO": "sample string 7"
          },
          "buildingServiceability": {
            "fiberBuildingStatus": "sample string 1",
            "coaxServiceabilityColor": "sample string 2",
            "wholesaleFiberServiceability": "sample string 3",
            "serviceabilityStatusCodeNew": "sample string 4",
            "tierType": "sample string 5",
            "fttpType": "sample string 6"
          },
          "serviceabilityProximity": {
            "distanceToClosestServiceableBuilding": 1,
            "distanceToClosestServiceableBuildingSpecified": true,
            "closestServiceableBuildingKey": 3,
            "closestServiceableBuildingKeySpecified": true,
            "fiberPointRightTriangleDistance": 5,
            "fiberPointRightTriangleDistanceSpecified": true
          },
          "addressType": "sample string 6",
          "spectrumDivision": "sample string 7",
          "spectrumRegion": "sample string 8",
          "spectrumMarketArea": "sample string 9"
        },
        "businessMatchStatus": "sample string 5",
        "clientBusinessKey": "sample string 6",
        "requestNumber": 7
      },
      {
        "address": "sample string 1",
        "city": "sample string 2",
        "state": "Item",
        "stateSpecified": true,
        "zipCode": "sample string 4",
        "businessMatchDetail": {
          "businessKey": 1,
          "businessKeySpecified": true,
          "businessName": "sample string 3",
          "buildingKey": 4,
          "buildingKeySpecified": true,
          "buildingAddress": {
            "buildingName": "sample string 1",
            "address": "sample string 2",
            "city": "sample string 3",
            "state": "Item",
            "stateSpecified": true,
            "zipCode": "sample string 5"
          },
          "billingDescriptors": {
            "billingInstanceName": "sample string 1",
            "billingInstanceKey": 2,
            "billingInstanceKeySpecified": true,
            "billingSystemTypeIndicator": "sample string 4",
            "billingSiteID": 5,
            "billingSiteIDSpecified": true,
            "franchiseCode": {
              "fullFranchiseCode": "sample string 1",
              "csg": {
                "sys": "sample string 1",
                "prin": "sample string 2",
                "agent": "sample string 3"
              },
              "icoms": {
                "siteID": "sample string 1",
                "company": "sample string 2",
                "division": "sample string 3",
                "franchiseArea": "sample string 4"
              }
            },
            "legacyMSO": "sample string 7"
          },
          "buildingServiceability": {
            "fiberBuildingStatus": "sample string 1",
            "coaxServiceabilityColor": "sample string 2",
            "wholesaleFiberServiceability": "sample string 3",
            "serviceabilityStatusCodeNew": "sample string 4",
            "tierType": "sample string 5",
            "fttpType": "sample string 6"
          },
          "serviceabilityProximity": {
            "distanceToClosestServiceableBuilding": 1,
            "distanceToClosestServiceableBuildingSpecified": true,
            "closestServiceableBuildingKey": 3,
            "closestServiceableBuildingKeySpecified": true,
            "fiberPointRightTriangleDistance": 5,
            "fiberPointRightTriangleDistanceSpecified": true
          },
          "addressType": "sample string 6",
          "spectrumDivision": "sample string 7",
          "spectrumRegion": "sample string 8",
          "spectrumMarketArea": "sample string 9"
        },
        "businessMatchStatus": "sample string 5",
        "clientBusinessKey": "sample string 6",
        "requestNumber": 7
      }
    ],
    "count": "sample string 1"
  },
  "serviceReturnStatus": {
    "returnCode": 1,
    "returnMessage": "sample string 2",
    "responseTypeCode": 3,
    "responseTypeCodeSpecified": true,
    "responseTypeMessage": "sample string 5",
    "currentPeriodRequestsUsed": 6,
    "currentPeriodRequestsAvailable": 7
  }
}

application/xml, text/xml

Sample:

<BulkBusinessSearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Twc.MidasWebServices">
  <BusinessCandidateList>
    <businessCandidateField>
      <BusinessCandidateListBusinessCandidate>
        <addressField>sample string 1</addressField>
        <businessMatchDetailField>
          <addressTypeField>sample string 6</addressTypeField>
          <billingDescriptorsField>
            <billingInstanceKeyField>2</billingInstanceKeyField>
            <billingInstanceKeyFieldSpecified>true</billingInstanceKeyFieldSpecified>
            <billingInstanceNameField>sample string 1</billingInstanceNameField>
            <billingSiteIDField>5</billingSiteIDField>
            <billingSiteIDFieldSpecified>true</billingSiteIDFieldSpecified>
            <billingSystemTypeIndicatorField>sample string 4</billingSystemTypeIndicatorField>
            <franchiseCodeField>
              <cSGField>
                <agentField>sample string 3</agentField>
                <prinField>sample string 2</prinField>
                <sysField>sample string 1</sysField>
              </cSGField>
              <fullFranchiseCodeField>sample string 1</fullFranchiseCodeField>
              <iCOMSField>
                <companyField>sample string 2</companyField>
                <divisionField>sample string 3</divisionField>
                <franchiseAreaField>sample string 4</franchiseAreaField>
                <siteIDField>sample string 1</siteIDField>
              </iCOMSField>
            </franchiseCodeField>
            <legacyMSOField>sample string 7</legacyMSOField>
          </billingDescriptorsField>
          <buildingAddressField>
            <addressField>sample string 2</addressField>
            <buildingNameField>sample string 1</buildingNameField>
            <cityField>sample string 3</cityField>
            <stateField>Item</stateField>
            <stateFieldSpecified>true</stateFieldSpecified>
            <zIPCodeField>sample string 5</zIPCodeField>
          </buildingAddressField>
          <buildingKeyField>4</buildingKeyField>
          <buildingKeyFieldSpecified>true</buildingKeyFieldSpecified>
          <buildingServiceabilityField>
            <coaxServiceabilityColorField>sample string 2</coaxServiceabilityColorField>
            <fTTPTypeField>sample string 6</fTTPTypeField>
            <fiberBuildingStatusField>sample string 1</fiberBuildingStatusField>
            <serviceabilityStatusCodeNewField>sample string 4</serviceabilityStatusCodeNewField>
            <tierTypeField>sample string 5</tierTypeField>
            <wholesaleFiberServiceabilityField>sample string 3</wholesaleFiberServiceabilityField>
          </buildingServiceabilityField>
          <businessKeyField>1</businessKeyField>
          <businessKeyFieldSpecified>true</businessKeyFieldSpecified>
          <businessNameField>sample string 3</businessNameField>
          <serviceabilityProximityField>
            <closestServiceableBuildingKeyField>3</closestServiceableBuildingKeyField>
            <closestServiceableBuildingKeyFieldSpecified>true</closestServiceableBuildingKeyFieldSpecified>
            <distanceToClosestServiceableBuildingField>1</distanceToClosestServiceableBuildingField>
            <distanceToClosestServiceableBuildingFieldSpecified>true</distanceToClosestServiceableBuildingFieldSpecified>
            <fiberPointRightTriangleDistanceField>5</fiberPointRightTriangleDistanceField>
            <fiberPointRightTriangleDistanceFieldSpecified>true</fiberPointRightTriangleDistanceFieldSpecified>
          </serviceabilityProximityField>
          <spectrumDivisionField>sample string 7</spectrumDivisionField>
          <spectrumMarketAreaField>sample string 9</spectrumMarketAreaField>
          <spectrumRegionField>sample string 8</spectrumRegionField>
        </businessMatchDetailField>
        <businessMatchStatusField>sample string 5</businessMatchStatusField>
        <cityField>sample string 2</cityField>
        <clientBusinessKeyField>sample string 6</clientBusinessKeyField>
        <requestNumberField>7</requestNumberField>
        <stateField>Item</stateField>
        <stateFieldSpecified>true</stateFieldSpecified>
        <zIPCodeField>sample string 4</zIPCodeField>
      </BusinessCandidateListBusinessCandidate>
      <BusinessCandidateListBusinessCandidate>
        <addressField>sample string 1</addressField>
        <businessMatchDetailField>
          <addressTypeField>sample string 6</addressTypeField>
          <billingDescriptorsField>
            <billingInstanceKeyField>2</billingInstanceKeyField>
            <billingInstanceKeyFieldSpecified>true</billingInstanceKeyFieldSpecified>
            <billingInstanceNameField>sample string 1</billingInstanceNameField>
            <billingSiteIDField>5</billingSiteIDField>
            <billingSiteIDFieldSpecified>true</billingSiteIDFieldSpecified>
            <billingSystemTypeIndicatorField>sample string 4</billingSystemTypeIndicatorField>
            <franchiseCodeField>
              <cSGField>
                <agentField>sample string 3</agentField>
                <prinField>sample string 2</prinField>
                <sysField>sample string 1</sysField>
              </cSGField>
              <fullFranchiseCodeField>sample string 1</fullFranchiseCodeField>
              <iCOMSField>
                <companyField>sample string 2</companyField>
                <divisionField>sample string 3</divisionField>
                <franchiseAreaField>sample string 4</franchiseAreaField>
                <siteIDField>sample string 1</siteIDField>
              </iCOMSField>
            </franchiseCodeField>
            <legacyMSOField>sample string 7</legacyMSOField>
          </billingDescriptorsField>
          <buildingAddressField>
            <addressField>sample string 2</addressField>
            <buildingNameField>sample string 1</buildingNameField>
            <cityField>sample string 3</cityField>
            <stateField>Item</stateField>
            <stateFieldSpecified>true</stateFieldSpecified>
            <zIPCodeField>sample string 5</zIPCodeField>
          </buildingAddressField>
          <buildingKeyField>4</buildingKeyField>
          <buildingKeyFieldSpecified>true</buildingKeyFieldSpecified>
          <buildingServiceabilityField>
            <coaxServiceabilityColorField>sample string 2</coaxServiceabilityColorField>
            <fTTPTypeField>sample string 6</fTTPTypeField>
            <fiberBuildingStatusField>sample string 1</fiberBuildingStatusField>
            <serviceabilityStatusCodeNewField>sample string 4</serviceabilityStatusCodeNewField>
            <tierTypeField>sample string 5</tierTypeField>
            <wholesaleFiberServiceabilityField>sample string 3</wholesaleFiberServiceabilityField>
          </buildingServiceabilityField>
          <businessKeyField>1</businessKeyField>
          <businessKeyFieldSpecified>true</businessKeyFieldSpecified>
          <businessNameField>sample string 3</businessNameField>
          <serviceabilityProximityField>
            <closestServiceableBuildingKeyField>3</closestServiceableBuildingKeyField>
            <closestServiceableBuildingKeyFieldSpecified>true</closestServiceableBuildingKeyFieldSpecified>
            <distanceToClosestServiceableBuildingField>1</distanceToClosestServiceableBuildingField>
            <distanceToClosestServiceableBuildingFieldSpecified>true</distanceToClosestServiceableBuildingFieldSpecified>
            <fiberPointRightTriangleDistanceField>5</fiberPointRightTriangleDistanceField>
            <fiberPointRightTriangleDistanceFieldSpecified>true</fiberPointRightTriangleDistanceFieldSpecified>
          </serviceabilityProximityField>
          <spectrumDivisionField>sample string 7</spectrumDivisionField>
          <spectrumMarketAreaField>sample string 9</spectrumMarketAreaField>
          <spectrumRegionField>sample string 8</spectrumRegionField>
        </businessMatchDetailField>
        <businessMatchStatusField>sample string 5</businessMatchStatusField>
        <cityField>sample string 2</cityField>
        <clientBusinessKeyField>sample string 6</clientBusinessKeyField>
        <requestNumberField>7</requestNumberField>
        <stateField>Item</stateField>
        <stateFieldSpecified>true</stateFieldSpecified>
        <zIPCodeField>sample string 4</zIPCodeField>
      </BusinessCandidateListBusinessCandidate>
    </businessCandidateField>
    <countField>sample string 1</countField>
  </BusinessCandidateList>
  <ServiceReturnStatus>
    <currentPeriodRequestsAvailableField>7</currentPeriodRequestsAvailableField>
    <currentPeriodRequestsUsedField>6</currentPeriodRequestsUsedField>
    <responseTypeCodeField>3</responseTypeCodeField>
    <responseTypeCodeFieldSpecified>true</responseTypeCodeFieldSpecified>
    <responseTypeMessageField>sample string 5</responseTypeMessageField>
    <returnCodeField>1</returnCodeField>
    <returnMessageField>sample string 2</returnMessageField>
  </ServiceReturnStatus>
  <TrackingID>sample string 1</TrackingID>
</BulkBusinessSearchResponse>