GetHouseAccounts

This call is to retrieve an array of HouseAccount objects for the location.

Request Parameters

Id int — (optional) Specify the Id of the HouseAccount you would like to retrieve HouseAccounts for

Response Parameters

Message string — Returns a PAR POS Error message if the request did not go through. Otherwise, this field will be null.
ResultCode int — Returns one of the following:
- 0 — Request went through successfully
- 1 — Request returned an unknown error
- 2 — Request was not valid
- 3 — Server is currently unavailable and unable to receive the request
- 4 — Access Denied
Accounts Array of HouseAccount — All HouseAccounts for this location.
HouseAccount Properties
- Id int — Unique Id of this HouseAccount
- AccountNumber string — Unique Account Number of this HouseAccount
- Active bool — True if House Account is active, False if not
- Address1 string — Address for this HouseAccount
- Address2 string — Address for this HouseAccount
- Address3 string — Address for this HouseAccount
- Address4 string — Address for this HouseAccount
- Balance decimal — Balance of this HouseAccount
- City string — City of this HouseAccount
- EmailAddress string — Email address for this HouseAccount
- EnforceLimit bool — True if value in the Limit field is enforced, False if not
- FirstName string — First name of the person who owns this HouseAccount
- LastName string — Last name of the person who owns this HouseAccount
- Limit decimal — Limit for this HouseAccount, or 0 if there is no limit
- MiddleName string — Middle name of the person who owns this HouseAccount
- Name string — Name of the person who owns this HouseAccount
- PhoneNumber string — Phone number for this HouseAccount
- State string — State of this HouseAccount
- Zip string — Zip code of this HouseAccount

Headers

SOAPAction
Type: string
required

Body

required

application/json

SOAP envelope containing the GetHouseAccounts request. No parameters required.

Responses

text/xml; charset=utf-8

post/GetHouseAccounts

cURL

curl --request POST \
  --url 'https://{server_name_goes_here}.parpos.com/HouseAccounts.svc?GetHouseAccounts' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --header 'AccessToken: your-access-token' \
  --header 'LocationToken: your-location-token' \
  --header 'SOAPAction: "http://www.brinksoftware.com/webservices/houseaccounts/IHouseAccountsWebService/GetHouseAccounts"' \
  --data '<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:hous="http://www.brinksoftware.com/webservices/houseaccounts">
    <soapenv:Header/>
    <soapenv:Body>
      <hous:GetHouseAccounts>
        <hous:request/>
      </hous:GetHouseAccounts>
    </soapenv:Body>
  </soapenv:Envelope>'

Show Schema

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <GetHouseAccountsResponse xmlns="http://www.brinksoftware.com/webservices/houseaccounts">
      <GetHouseAccountsResult>
        <Message>Success</Message>
        <ResultCode>0</ResultCode>
        <Accounts>
          <HouseAccount>
            <Id>1</Id>
            <AccountNumber>HA-1001</AccountNumber>
            <Active>true</Active>
            <Address1>123 Main Street</Address1>
            <Address2>Suite 100</Address2>
            <Address3></Address3>
            <Address4></Address4>
            <Balance>150.00</Balance>
            <City>Atlanta</City>
            <EmailAddress>john.smith@example.com</EmailAddress>
            <EnforceLimit>true</EnforceLimit>
            <FirstName>John</FirstName>
            <LastName>Smith</LastName>
            <Limit>500.00</Limit>
            <MiddleName></MiddleName>
            <Name>John Smith</Name>
            <PhoneNumber>555-123-4567</PhoneNumber>
            <State>GA</State>
            <Zip>30301</Zip>
          </HouseAccount>
        </Accounts>
      </GetHouseAccountsResult>
    </GetHouseAccountsResponse>
  </s:Body>
</s:Envelope>

SOAP response containing an array of HouseAccount objects.