Admin APIs

Add a Price

POST /prices
Api key auth

Add a new price

application/json

Body

  • price object
    Hide price attributes Show price attributes object
    • 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

Responses

  • 201 application/json

    Price created

    Hide response attributes Show response 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)
POST /prices 
curl \
 --request POST 'https://app.getfoundation.com/api/external/v1/prices' \
 --header "X-API-Key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"price":{"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}}'
Request examples 
{
  "price": {
    "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
  }
}
Response examples (201) 
{
  "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"
}