---
title: "Get sales"
method: GET
path: "/api/v2/host/sales"
tags: ["host"]
---

# Get sales

`GET /api/v2/host/sales`

## Request

- Base URL: `https://api.momence.com`
- URL: `https://api.momence.com/api/v2/host/sales`
- Auth: OAuth 2
  - Authorization code: `/api/v2/auth/authorize`
  - Password
  - Token URL: `/api/v2/auth/token`

**Note:** This is an experimental feature, please contact support if you want to utilize this endpoint. 
 
This endpoint returns a list of host sales. 
The default sorting mode is DESC (newest sales first), but you can also specify ASC (oldest sales first). 
For session and appointment sales, additional meta data is returned in the response.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` string

## Response `200`

- object
  - `pagination` PaginatedResponseDataDto, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `sortBy` string
    - `sortOrder` 'ASC' | 'DESC'
  - `payload` HostSaleDto[], required
    - `id` integer, required
    - `saleDate` string, date-time, required
    - `items` HostSaleItemDto[], required
      - `id` integer, required
      - `saleItemId` integer, required
      - `itemType` 'membership' | 'session' | 'appointment' | 'product' | 'video' | 'course' | 'gift-card' | 'monthly-subscription' | 'custom-member-payment-plan-installment' | 'money-credit' | 'event-credit' | 'auto-attendance-penalty' | 'auto-attendance-penalty-retry-fee' | 'stripe-refund' | 'refund' | 'tips' | 'appointment-deposit' | 'tuition-installment' | 'tuition-registration-fee' | 'appointment-addon' | 'open-area-visit' | 'membership-freeze-fee' | 'membership-renewal-retry-fee' | 'membership-cancellation-fee' | 'membership-transfer-fee' | 'membership-joining-fee' | 'session-addon' | 'reward-points' | 'imported-sale', required
      - `itemName` string, required
      - `descriptiveItemName` string, required
      - `payingMember` HostSaleMemberDto, required
        - `id` integer, required
        - `firstName` string, required
        - `lastName` string, required
      - `targetMember` HostSaleMemberDto, required
        - `id` integer, required
        - `firstName` string, required
        - `lastName` string, required
      - `session` HostSaleSessionDto
        - `id` integer, required
        - `name` string, required
        - `startsAt` string, date-time, required
        - `endsAt` string, date-time, required
      - `appointment` HostSaleAppointmentDto
        - `id` integer, required
        - `name` string, required
      - `product` HostSaleProductDto
        - `id` integer, required
        - `name` string, required
      - `productVariant` HostSaleProductVariantDto
        - `id` integer, required
        - `name` string, required
      - `openArea` HostSaleOpenAreaDto
        - `id` integer, required
        - `name` string, required
      - `quantity` number, required
      - `unitPriceExcludingTaxInCurrency` string, required
      - `unitTaxAmountInCurrency` string, required
      - `discountCode` ApiV2HostPaymentTransactionSaleDiscountCodeDto, nullable, required
        - `id` integer, required
        - `discountCodeId` integer, nullable, required
        - `priceRuleId` integer, nullable, required
        - `tuitionDiscountId` integer, nullable, required
        - `type` 'percentage' | 'value', required
        - `code` string, required
        - `unitDiscountExcludingTaxInCurrency` string, required
        - `unitDiscountTaxAmountInCurrency` string, required
    - `paymentTransaction` HostSalePaymentTransactionDto, required
      - `items` HostSalePaymentTransactionItemDto[], required
        - `id` integer, required
        - `paymentMethodType` 'stripe' | 'stripe-becs' | 'stripe-nz-becs' | 'stripe-revolut-pay' | 'stripe-ideal' | 'stripe-ideal-sepa-direct-debit' | 'stripe-bancontact' | 'stripe-bancontact-sepa-direct-debit' | 'stripe-sepa-direct-debit' | 'stripe-ach-direct-debit' | 'stripe-acss-debit' | 'stripe-bacs-direct-debit' | 'stripe-twint' | 'stripe-refund' | 'membership' | 'cash' | 'free' | 'imported' | 'custom' | 'scheduled-stripe' | 'paypal' | 'xendit' | 'classpass' | 'gympass' | 'gift-card' | 'stripe-reader' | 'pay-later' | 'pay-at-start' | 'money-credit-correction' | 'money-credit-refund' | 'event-credit-correction' | 'event-credit-refund' | 'tuition' | 'urban-sports-club' | 'my-clubs' | 'referral-reward' | 'referral-gift' | 'campaign-sequence-action' | 'reward-points-corrections' | 'reward-points-earned' | 'reward-points-spent' | 'multiple-payment-methods' | 'yappy' | 'odin-card' | 'odin-ach' | 'odin-reader', required
        - `paymentMethodName` string: Additional name for the payment method used - for CUSTOM, it's custom payment method name, for MEMBERSHIP it's the membership name
        - `amountInCurrencyWithoutTax` string, required
        - `taxAmountInCurrency` string, required

## Changes

- **2026-11-03** `5adb9a85439b`: 3 warning, 1 info
  - added the new `imported-sale` enum value to the `allOf[subschema #2]/payload/items/items/items/itemType` response property for the response status `200`
  - added the new `reward-points` enum value to the `allOf[subschema #2]/payload/items/items/items/itemType` response property for the response status `200`
  - added the new `stripe-twint` enum value to the `allOf[subschema #2]/payload/items/paymentTransaction/items/items/paymentMethodType` response property for the response status `200`
  - added the required property `allOf[subschema #2]/payload/items/items/items/discountCode` to the response with the `200` status

[Operation history](https://skmtc.dev/momence/apis/momence-public/changes/api/v2/host/sales/get.md)

---

[API](https://skmtc.dev/momence/apis/momence-public.md) - [All operations](https://skmtc.dev/momence/apis/momence-public/llms.txt) - [OpenAPI document](https://skmtc.dev/momence/apis/momence-public/revisions/5adb9a85439b?raw)
