Get Prices

GET /prices

Get a list of prices

Query parameters

  • page integer(int32)

    Page Number

  • limit integer(int32)

    Number of items per page

  • price_list_id string(guid)

    Filter prices by price list ID

  • item_id string(guid)

    Filter prices by item ID

Responses

  • 200 application/json

    A list of prices

    Hide response attributes Show response attributes object
    • pagination object
      Hide pagination attributes Show pagination attributes object
      • current integer(int32)
      • previous integer(int32)
      • next integer(int32)
      • limit integer(int32)
      • total_pages integer(int32)
      • total_count integer(int32)
    • data array[object]
      Hide data attributes Show data attributes object
      • id string(guid)

        System generated unique identifier. Don't include this in POST request body.

      • price_list_id string(guid)
      • item_id string(guid)
      • scheme string(json)

        A JSON object with key as the quantity and value as the price. In the example, the price for 1 item is $99.99 and for 10 items and above is $89.99 Example: {"1": 99.99, "10": 89.99}

      • msrp string(float)

        Manufacturer Suggested Retail Price

      • map string(float)

        Minimum Advertised Price

      • moq integer(int32)

        Minimum Order Quantity

      • quantity_multiplier integer(int32)

        Multiple of quantity to be ordered

      • cost_price string(float)

        Cost Price

      • created_at string(date-time)
      • updated_at string(date-time)
GET /prices
curl \
 --request GET 'https://app.getfoundation.com/api/external/v1/prices' \
 --header "X-API-Key: $API_KEY"
Response examples (200)
{
  "pagination": {
    "current": 42,
    "previous": 42,
    "next": 42,
    "limit": 42,
    "total_pages": 42,
    "total_count": 42
  },
  "data": [
    {
      "id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
      "price_list_id": "string",
      "item_id": "string",
      "scheme": {
        "1": 99.99,
        "10": 89.99
      },
      "msrp": 99.99,
      "map": 99.99,
      "moq": 10,
      "quantity_multiplier": 1,
      "cost_price": 49.99,
      "created_at": "2025-05-04T09:42:00Z",
      "updated_at": "2025-05-04T09:42:00Z"
    }
  ]
}