---
title: "🔒 List sales prices V3"
method: GET
path: "/api/v3/salesPrices"
tags: ["SalesPrice"]
---

# 🔒 List sales prices V3

`GET /api/v3/salesPrices`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: `salesPrice:read`.

Paginated list of SalesPrices.

## Query parameters

- `filter` object[]
  - `key` 'id' | 'product.id' | 'customer.id' | 'group.id' | 'currency' | 'amount' | 'remark' | 'validFrom' | 'expiresAt' | 'createdAt' | 'updatedAt'
  - `op` 'equals' | 'notEquals' | 'in' | 'notIn' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'lessThanOrEquals' | 'greaterThanOrEquals' — operator
  - `value` union — The property value.
    - string
    - string[]
- `sort` string[]
- `perPage` integer
- `page` integer

## Response `200`

Paginated list of SalesPrices.

- object
  - `data` object[]
    - `id` string — SalesPrice ID
    - `product` object — Product
      - `id` string — Product ID
    - `customer` object — Customer
      - `id` string — Customer ID
    - `customerGroup` object — Customer group
      - `id` string — Customer group ID
    - `price` object — Money
      - `amount` union
        - string
        - number
      - `currency` string — Currency
    - `amount` number, float — Amount
    - `packageAmount` unknown
    - `customerProductNumber` string — Customer product number
    - `isNotCalculatedFromExchangeTable` boolean — Whether is calculated from exchange table
    - `hideInBulkPriceListing` boolean — Whether to hide from bulk price listing
    - `remark` string — Remark
    - `validFrom` string, date — Valid from date
    - `expiresAt` string, date — Expires at date
  - `meta` object — Pagination meta data
    - `currentPage` integer — The current page number
    - `from` integer, nullable — The first item being returned in the current page
    - `path` string — The base path for the paginated results
    - `perPage` integer — The number of items shown per page
    - `to` integer, nullable — The last item being returned in the current page
  - `links` object — Pagination links
    - `first` string, nullable — URL to the first page
    - `last` string, nullable — URL to the last page
    - `prev` string, nullable — URL to the previous page
    - `next` string, nullable — URL to the next page

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)