---
title: "Get all price guards"
method: GET
path: "/api-offers/price-guard"
tags: ["Price Guard"]
---

# Get all price guards

`GET /api-offers/price-guard`

## Request

- Base URL: `https://live.copilot.fabric.inc`
- URL: `https://live.copilot.fabric.inc/api-offers/price-guard`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/offers-v2/docs/api-offers/price-guard/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a paginated list of price guards based on query parameters.

## Query parameters

- `limit` number
- `offset` number
- `itemId` integer
- `priceListId` integer
- `sortBy` 'priceListId' | 'itemId' | 'updatedAt'
- `sortOrder` 'desc, asc'

## Headers

- `x-site-context` string, required

## Response `200`

OK

- ListPriceGuardResponse
  - `query` object: Pagination details used for selecting list
    - `limit` number: The maximum number of records per page.
    - `count` number: The total number of records.
    - `offset` number: The number of records to skip before returning records. For example, when offset is 20 and limit is 10, this endpoint returns records from 21 to 30.
    - `itemId` number: ID of the item for which price guard records are fetched
    - `priceListId` number: ID of the pricelist for which price guard records are fetched
    - `sortBy` 'updatedAt' | 'priceListId' | 'priceListName' | 'ItemId': Field by which records are sort. Default is `updatedAt`
    - `sortOrder` 'asc' | 'desc': Sorting order- ascending or descending
  - `data` PriceGuard[]: Price guard details
    - `_id` string: fabric database ObjectId of the record
    - `itemId` integer: Item ID
    - `itemSku` string: Item SKU
    - `priceListId` integer: ID of the pricelist under which the price kinds are created
    - `MSRP` number: Manufacturer suggested retail price
    - `MAP` number: Minimum advertised price
    - `ceiling` number: Maximum price the seller is allowed to charge for the product. Price created for the item ID or item SKU under the specified pricelist should not exceed the given ceiling price.
    - `floor` number: Lowest price at which the product can be sold. Price created for the item ID or item SKU under the specified pricelist should not be lower than the given floor price.
    - `deleted` boolean: true: price guard is deleted<br /> false: price guard is not deleted
    - `createdAt` string, date-time: Creation date of the record
    - `updatedAt` string, date-time: Last updated date of the record

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/fabric/apis/offers-v2.md) - [All operations](https://skmtc.dev/fabric/apis/offers-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/offers-v2/revisions/da2bd742b9bc?raw)