v1

latestOpenAPI 3.1.02026-07-2665153355.3 KB

Create a Price Point

Creates a price point.

When you pass the base price in USD, the API returns localized prices for this price point in all currencies supported by Appcharge. Learn more about how localized prices are calculated.

To override automatically calculated prices for specific countries, pass the priceOverrides property with the relevant country codes and your custom prices.

post/v1/price-points

Request body

priceInUsdCentsnumber

Base price in USD cents.

Example request

{
  "priceInUsdCents": 999,
  "priceOverrides": [
    {
      "countryCode2": "BR",
      "price": 29.99
    }
  ]
}

Response

Price point created successfully.

priceInUsdCentsnumber

Base price in USD cents.

lastUpdatestring date-time

Timestamp indicating when the price point was last updated, in UTC ISO 8601 format.

Example response

{
  "priceInUsdCents": 999,
  "lastUpdate": "2026-01-01T14:30:00Z",
  "priceByCountry": [
    {
      "price": 7.99,
      "currencyCode": "GBP",
      "taxModel": "Included",
      "taxRate": 20,
      "country": "United Kingdom",
      "countryCode2": "GB",
      "usdExchangeRateOnCalc": 0.79,
      "exchangeRateDrift": "-1.2%"
    }
  ]
}