GetParty

​

Retrieve an open Party at the location.

Request Parameters
  • BusinessDate DateTime — The Current Business Date of the location.
  • TableId int — Specify the Table that contains the party we want to retrieve information 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 — Success
    • 1 — Unknown Error
    • 2 — Invalid Request
    • 3 — Server Unavailable
    • 4 — Access Denied
    • 101 — Party with the BusinessDate and TableId specified was not found

  • Party Party — Party with the BusinessDate and TableId you specified, if one is found.

    Party Properties

    • CreatedTime DateTime — Date and time this Party was created in UTC

    • Id long — Unique Id of this Party

    • Name string — Name of this Party

    • Orders Array of Order — Orders in this Party

      Order Properties

      • BusinessDate DateTime — Business date of this Order (the time component will always return as 00:00:00)

      • ClosedTime DateTimeOffset? — Date and time this Order was closed in UTC, null if not yet closed

      • Count int — Returns one of the following, depending on content of the Order: 0 = Reflects an empty Order (e.g. Entries deleted or voided, Total is 0), 1 = Reflects a full Order

      • CustomerId Guid? — Id of the Customer on this Order, or null if there was no assigned Customer

      • Deposits Array of OrderDeposit — Deposits paid for this Order, typically for future date orders

        OrderDeposit Properties
        • Amount decimal — Amount of this OrderDeposit
        • BusinessDate DateTime — Business date this OrderDeposit was taken
        • EmployeeId int? — Maps to the Id of the Employee who applied this OrderDeposit
        • Id int — Unique Id of this OrderDeposit
        • IsApplied bool — True if this OrderDeposit has been applied to the Order, False if not
        • IsDeleted bool — True if this OrderDeposit has been deleted, False if not
        • IsReversal bool — True if this OrderDeposit is a reversal that offsets a deleted deposit, False if not
        • OriginalOrderDepositId int? — Id of the original OrderDeposit being reversed, if this OrderDeposit is a reversal
        • PaymentId int — Id of the OrderPayment that correlates to this OrderDeposit
        • TenderId int — Maps to the Id of the Tender used for this OrderDeposit

      • DestinationId int? — Maps to the Id of the Destination of this Order

      • Discounts Array of OrderDiscount — Discounts applied to this Order

        OrderDiscount Properties
        • Amount decimal — Amount of this OrderDiscount
        • ApproverEmployeeId int? — Maps to the Id of the Employee who approved this OrderDiscount
        • DiscountId int — Maps to the Id of the Discount for this OrderDiscount
        • EmployeeId int? — Maps to the Id of the Employee who applied this OrderDiscount
        • ExternalLoyaltyAccount string — Number of the external loyalty account through which this OrderDiscount is applied
        • Id int — Unique Id of this OrderDiscount within the Order
        • LoyaltyRewardId int? — Maps to the Id of the LoyaltyReward if this OrderDiscount is applied via a loyalty reward
        • Name string — Name of this OrderDiscount
        • Source int — 0 = Other, 1 = LoyaltyCard, 2 = LoyaltyReward

      • DisplaySubtotal decimal — Same as Subtotal unless this Order contains inclusive tax, then those taxes would be added to this DisplaySubtotal and subtracted from DisplayTax

      • DisplayTax decimal — Same as Tax unless this Order contains inclusive tax, then those taxes won't be counted in this DisplayTax

      • EmployeeId int? — Maps to the Id of the Employee who processed this Order

      • Entries Array of OrderEntry — Entries in this Order. An OrderEntry can either be of type OrderItem or an OrderGiftCard.

        OrderEntry — OrderItem Properties

        • CompositeOrderItemId int? — Maps to the Id of the OrderItem within the Order that is the CompositeOrderItem, if this OrderItem is part of a combo

        • DayPartId int? — Maps to the Id of the DayPart of this OrderItem

        • Denominator byte — Denominator by which this OrderItem was split

        • Description string — Description of this OrderItem

        • DestinationId int? — Maps to the Id of the Destination of this OrderItem

        • Discounts Array of OrderItemDiscount — Discounts applied to this OrderItem

          OrderItemDiscount Properties
          • Amount decimal — Amount of discount applied to the OrderItem
          • Id int — Unique Id of this OrderItemDiscount within the OrderItem
          • OrderDiscountId int — Maps to the Id of the Discount for this OrderItemDiscount

        • DisplayPrice decimal — Price displayed for this OrderItem

        • GrossSales decimal — Gross sales for this OrderItem and its children

        • Id int — Unique Id of this OrderItem within the Order

        • IsCleared bool — True if this OrderItem was cleared, False if not

        • IsDeleted bool — True if this OrderItem was deleted, False if not

        • IsVoided bool — True if this OrderItem was voided, False if not

        • ItemGrossSales decimal — Gross sales for this OrderItem only

        • ItemId int — Maps to the Id of the Item of this OrderItem

        • ItemNetSales decimal — Net sales for this OrderItem only

        • Modifiers Array of OrderItemModifier — Modifiers applied to this OrderItem

          OrderItemModifier Properties

          • DisplayPrice decimal — Price displayed for this OrderItemModifier

          • GrossSales decimal — Gross sales for this OrderItemModifier and its children

          • Id int — Unique Id of this OrderItemModifier within the OrderItem

          • ItemGrossSales decimal — Gross sales for this OrderItemModifier only

          • ItemId int — Maps to the Id of the Item for this OrderItemModifier

          • ItemNetSales decimal — Net sales for this OrderItemModifier only

          • ModifierCodeId int — Maps to the Id of the ModifierCode for this OrderItemModifier

          • ModifierGroupId int — Maps to the Id of the ModifierGroup for this OrderItemModifier

          • Modifiers Array of OrderItemModifier — Nested modifiers

          • NetSales decimal — Net sales for this OrderItemModifier and its children

          • Price decimal — Price of this OrderItemModifier

          • Taxes Array of OrderEntryTax — Taxes applied to this OrderItemModifier

            OrderEntryTax Properties
            • Amount decimal — Amount of tax applied to the OrderEntry
            • Id int — Unique Id of this OrderEntryTax within the OrderEntry
            • IsInclusive bool — True if this OrderEntryTax is an inclusive tax, False if not
            • TaxId int — Maps to the Id of the Tax of this OrderEntryTax

        • NetSales decimal — Net sales for this OrderItem and its children

        • NonRevenueItem bool — True if this OrderItem is a non-revenue Item, False if not

        • Note string — Note for this OrderItem

        • Promotions Array of OrderEntryPromotion — Promotions applied to this OrderItem

          OrderEntryPromotion Properties
          • Amount decimal — Amount of promotion applied to the OrderEntry
          • Id int — Unique Id of this OrderItemPromotion within the OrderEntry
          • OrderPromotionId int — Maps to the Id of the Promotion of this OrderEntryPromotion

        • Price decimal — Price of this OrderItem

        • RevenueCenterId int — Maps to the Id of the RevenueCenter of this OrderItem

        • SplitItemId short — Maps to the Id of the OrderItem within the Order that this OrderItem was split from

        • Taxes Array of OrderEntryTax — Taxes applied to this OrderItem

          OrderEntryTax Properties
          • Amount decimal — Amount of tax applied to the OrderEntry
          • Id int — Unique Id of this OrderEntryTax within the OrderEntry
          • IsInclusive bool — True if this OrderEntryTax is an inclusive tax, False if not
          • TaxId int — Maps to the Id of the Tax of this OrderEntryTax

        • Void OrderItemVoid — Details about a void, if this OrderItem was voided

          OrderItemVoid Properties
          • ApproverEmployeeId int — Maps to the Id of the Employee who approved this void
          • EmployeeId int — Maps to the Id of the Employee who performed this void
          • Time DateTimeOffset — Date and time this void was performed in UTC
          • VoidReasonId int — Maps to the Id of the VoidReason for this void
        OrderEntry — OrderGiftCard Properties

        • DayPartId int? — Maps to the Id of the DayPart of this OrderItem

        • Description string — Description of this OrderGiftCard

        • Id int — Unique Id of this OrderGiftCard within the Order

        • ItemId int — Maps to the Id of the Item of this OrderGiftCard

        • Price decimal — Price of this OrderGiftCard

        • Promotions Array of OrderEntryPromotion — Promotions applied to this OrderGiftCard

          OrderEntryPromotion Properties
          • Amount decimal — Amount of promotion applied to the OrderEntry
          • Id int — Unique Id of this OrderItemPromotion within the OrderEntry
          • OrderPromotionId int — Maps to the Id of the Promotion of this OrderEntryPromotion

      • FirstSendTime DateTimeOffset? — Date and time this Order was first sent to the kitchen in UTC, null if not sent

      • GrossSales decimal — Gross sales for this Order

      • GuestCount int — Number of guests for this Order

      • GuestCountFractional decimal — Fractional number of guests for this Order

      • Id long — Unique Id of this Order

      • IdEncoded string — Unique encoded Id of this Order

      • IdNoLocation int — Unique Id of this order with location identifier removed. This is shorter and generally passed to integrations, including credit processors.

      • IsClosed bool — True if this Order is closed, False if not

      • IsFutureOrder bool — True if this Order is a future order, False if not

      • IsRefund bool — True if this Order is a refund, False if not

      • IsTaxExempt bool — True if this Order is exempt from taxes, False if not

      • ModifiedTime DateTimeOffset — Date and time this Order was last modified in the location's local time

      • Name string — Name of this Order

      • NetSales decimal — Net sales for this Order

      • Number short — Order, receipt, or call out number that cashiers use to call the customer for this Order

      • OpenedTime DateTimeOffset — Date and time this Order was opened in UTC

      • OrderAdditionalDetails string — Additional loyalty or payment information for this Order, depending on each individual processor. Note: This is a JSON-formatted string.

      • Payments Array of OrderPayment — Payments applied to this Order

        OrderPayment Properties

        • Amount decimal — Amount of this OrderPayment

        • AdditionalData List<NameValuePair> — Any additional information

        • BusinessDate DateTime — Business date this OrderPayment was applied (time component is 00:00:00)

        • CardHolderName string — Name of the cardholder of this OrderPayment, for card payments

        • CardNumber string — Card number of this OrderPayment, populated for credit card and gift card payments (typically only the last 4 digits)

        • Change decimal — Change given on this OrderPayment

        • CreditCardTransactionInformation CreditCardTransactionInformation — Additional credit card transaction information returned by Vantiv

          CreditCardTransactionInformation Properties
          • AuthorizationCode string — Authorization code returned from Vantiv
          • CardToken string — Card token returned from Vantiv
          • ClientTransactionIdentifier string — Client transaction identifier returned from Vantiv
          • Result string — Result returned from Vantiv

        • Details Array of OrderPaymentDetail — Transactional details for this OrderPayment

          OrderPaymentDetail Properties
          • Amount decimal — Amount of this OrderPaymentDetail
          • EmployeeId int? — Maps to the Id of the Employee who processed this OrderPaymentDetail
          • Id int — Unique Id of this OrderPaymentDetail within the Order
          • TillNumber int? — Maps to the Number of the Till that this OrderPaymentDetail was originally taken on
          • TipAmount decimal — Tip amount for this OrderPaymentDetail
          • Type int — 1 = Initial Payment, 2 = Adjustment, 3 = Change given, 4 = Transfer from, 5 = Transfer to

        • EmployeeId int? — Maps to the Id of the Employee who applied this OrderPayment

        • Id int — Unique Id of this OrderPayment within the Order

        • IsDeleted bool — True if this OrderPayment was deleted, False if not

        • MerchantAccountType int? — For credit card payments: 0 = Standard Merchant Account, 1 = eCommerce Merchant Account

        • TenderId int — Maps to the Id of the Tender of this OrderPayment

        • TillNumber int? — Maps to the Number of the Till that this OrderPayment was originally taken on

        • TipAmount decimal — Tip amount for this OrderPayment

      • PickupTime DateTime? — Date and time this Order is scheduled for pick up in UTC, null if not applicable

      • Promotions Array of OrderPromotion — Promotions applied to this Order

        OrderPromotion Properties
        • Amount decimal — Amount of promotion applied to the Order
        • ApproverEmployeeId int? — Maps to the Id of the Employee who approved this OrderPromotion
        • EmployeeId int? — Maps to the Id of the Employee who applied this OrderPromotion
        • Id int — Unique Id of this OrderPromotion within the Order
        • Name string — Name of this OrderPromotion
        • PromotionId int — Maps to the Id of the Promotion of this OrderPromotion

      • Rounding decimal — Amount by which the Order was rounded to, reflecting the rounding settings

      • RefundReasonId int — Maps to the Id of the RefundReason used for this refund Order

      • SectionId int? — Maps to the Id of the Section of this Order

      • Subtotal decimal — Subtotal of this Order

      • Surcharges Array of OrderSurcharge — Surcharges applied to this Order

        OrderSurcharge Properties

        • Amount decimal — Amount of surcharge applied to the Order

        • ApproverEmployeeId int? — Maps to the Id of the Employee who approved this OrderSurcharge

        • EmployeeId int? — Maps to the Id of the Employee who applied this OrderSurcharge

        • Id int — Unique Id of this OrderSurcharge within the Order

        • IsSystemApplied bool — True if this OrderSurcharge is automatically applied by the system, False if not

        • Name string — Name of this OrderSurcharge

        • SurchargeId int — Maps to the Id of the Surcharge of this OrderSurcharge

        • Taxes Array of OrderEntryTax — Taxes on this OrderSurcharge

          OrderEntryTax Properties
          • Amount decimal — Amount of tax applied to the OrderEntry
          • Id int — Unique Id of this OrderEntryTax within the OrderEntry
          • IsInclusive bool — True if this OrderEntryTax is an inclusive tax, False if not
          • TaxId int — Maps to the Id of the Tax of this OrderEntryTax

      • Tax decimal — Total tax for this Order

      • Taxes Array of OrderTax — Order taxes applied to this Order

        OrderTax Properties
        • Amount decimal — Amount of tax applied to the Order
        • Id int — Unique Id of this OrderTax within the Order
        • TaxId int — Maps to the Id of the Tax of this OrderTax

      • TaxExemptId string — Tax identifier for the tax-exempt entity

      • TerminalId int — Id of the terminal this Order was placed on

      • TillNumber int? — Id of the till that owns this Order, null if not owned

      • Total decimal — Total for this Order

    • OwnerEmployeeId int — Maps to the Id of the Employee who served this Party

    • Size decimal — Size of this Party

    • TableId int — Maps to the Id of the Table this party was served at

Headers
  • SOAPAction
    Type: string
    required
Body
required
application/json

SOAP envelope containing the GetParty request with BusinessDate and TableId.

Responses
  • text/xml; charset=utf-8
Request Example for post/GetParty
cURL
curl --request POST \
  --url 'https://{server_name_goes_here}.parpos.com/Ordering.svc?GetParty' \
  --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/ordering/20140219/IOrderingWebService/GetParty"' \
  --data '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ns="http://www.brinksoftware.com/webservices/ordering/20140219">
    <soapenv:Header/>
    <soapenv:Body>
      <ns:GetParty>
        <ns:request>
          <ns:BusinessDate>2024-01-15</ns:BusinessDate>
          <ns:TableId>12345</ns:TableId>
        </ns:request>
      </ns:GetParty>
    </soapenv:Body>
  </soapenv:Envelope>'

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <GetPartyResponse xmlns="http://www.brinksoftware.com/webservices/ordering/20140219">
      <GetPartyResult>
        <Message>Success</Message>
        <ResultCode>0</ResultCode>
        <Party>
          <CreatedTime>2024-01-15T18:00:00Z</CreatedTime>
          <Id>50001</Id>
          <Name>Table 5</Name>
          <Orders>
            <Order>
              <Balance>0.00</Balance>
              <BusinessDate>2024-01-15T00:00:00</BusinessDate>
              <CreatedTime>2024-01-15T18:05:00Z</CreatedTime>
              <CustomerId>00000000-0000-0000-0000-000000000000</CustomerId>
              <DestinationId>1</DestinationId>
              <Discounts/>
              <Entries>
                <OrderEntry i:type="OrderItem">
                  <ComboItems/>
                  <ComponentId i:nil="true"/>
                  <CompositeOrderItemId>0</CompositeOrderItemId>
                  <Denominator>1</Denominator>
                  <Description>Steak Dinner</Description>
                  <DestinationId>1</DestinationId>
                  <Discounts/>
                  <Id>1</Id>
                  <ItemId>301</ItemId>
                  <Modifiers/>
                  <Note>Medium rare</Note>
                  <Price>24.99</Price>
                  <Promotions/>
                  <Seat>1</Seat>
                  <SplitItemId>0</SplitItemId>
                  <Taxes>
                    <OrderEntryTax>
                      <Amount>2.00</Amount>
                      <Id>1</Id>
                      <TaxId>1</TaxId>
                    </OrderEntryTax>
                  </Taxes>
                </OrderEntry>
              </Entries>
              <FutureOrder i:nil="true"/>
              <Id>99001</Id>
              <IdEncoded>OTkwMDE=</IdEncoded>
              <IsClosed>false</IsClosed>
              <IsSent>true</IsSent>
              <IsTaxExempt>false</IsTaxExempt>
              <LaneId>1</LaneId>
              <Name>Guest 1</Name>
              <Number>2001</Number>
              <Payments/>
              <Promotions/>
              <Rounding>0.00</Rounding>
              <SectionId>1</SectionId>
              <Subtotal>24.99</Subtotal>
              <Surcharges/>
              <Tax>2.00</Tax>
              <Taxes>
                <OrderTax>
                  <Amount>2.00</Amount>
                  <Id>1</Id>
                  <TaxId>1</TaxId>
                </OrderTax>
              </Taxes>
              <Total>26.99</Total>
            </Order>
          </Orders>
          <OwnerEmployeeId>42</OwnerEmployeeId>
          <Size>2</Size>
          <TableId>5</TableId>
        </Party>
      </GetPartyResult>
    </GetPartyResponse>
  </s:Body>
</s:Envelope>

SOAP response containing the Party object.

Copyright © 2026 PAR Technology Corporation. All rights reserved.
PAR Technology Corporation 8383 Seneca Turnpike, Suite 3 New Hartford, New York 13413 (315) 738-0600 legal@partech.com. PAR Tech is a leading global provider of software, systems, and service solutions to the restaurant and retail industries. You may learn about its product offerings here.
Before using this application, please read the Limited License Agreement and the PAR Tech Terms of Use. In addition, the sample applications of PAR Technology are licensed under the terms of the O'Saasy License.