Skip to main content
POST
/
catalog
/
plans
/
{identifier}
/
prices
/
bulk
Update plan prices
curl --request POST \
  --url https://api.kelviq.com/api/v1/catalog/plans/{identifier}/prices/bulk/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prices": [
    {
      "priceType": "PAID",
      "currency": "USD",
      "freeTrial": false,
      "trialPeriod": 0,
      "enabled": true,
      "taxBehavior": "EXCLUSIVE",
      "chargeCatalogPrice": [
        {
          "feature": "3a3e92ab-90a3-4f43-8e87-9d4c8c5a9c01",
          "priceModel": "FLAT",
          "reset": "EVERY_MONTH",
          "resetTime": "BEGINNING_OF_PERIOD",
          "hasUnlimitedUsage": false,
          "paymentType": "ADVANCE_COMMITMENT",
          "rollover": {},
          "usageAlerts": {
            "enabled": true,
            "thresholds": [
              75,
              90
            ],
            "thresholdType": "PERCENTAGE"
          },
          "charges": [
            {
              "chargePeriod": "MONTHLY",
              "priceData": {
                "amount": 29.99
              },
              "tiers": [],
              "advanced": {}
            }
          ]
        }
      ]
    }
  ]
}
'
{
  "prices": [
    {
      "id": "df0b9da9-58c3-4d77-9b62-3f6e4c2b1ad0",
      "priceType": "PAID",
      "currency": "USD",
      "freeTrial": false,
      "trialPeriod": 14,
      "enabled": true,
      "taxBehavior": "EXCLUSIVE",
      "chargeCatalogPrice": [
        {
          "feature": "3a3e92ab-90a3-4f43-8e87-9d4c8c5a9c01",
          "priceModel": "FLAT",
          "reset": "EVERY_MONTH",
          "resetTime": "BEGINNING_OF_PERIOD",
          "hasUnlimitedUsage": false,
          "paymentType": "ADVANCE_COMMITMENT",
          "rollover": {},
          "usageAlerts": {
            "enabled": true,
            "thresholds": [
              75,
              90
            ],
            "thresholdType": "PERCENTAGE"
          },
          "charges": [
            {
              "chargePeriod": "MONTHLY",
              "priceData": {
                "amount": 29.99
              },
              "tiers": [],
              "advanced": {}
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'

Path Parameters

​
identifier
string
required

Plan identifier.

Body

application/json

Replaces the plan's prices in one atomic call. Creating multiple PAID prices with the same currency is rejected.

​
prices
object[]
required

Response

Prices replaced.

​
prices
object[]