Skip to main content
GET
/
price-bundles
curl "https://api.alguna.io/price-bundles?page=1&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "name": "Premium Bundle",
  "description": "A bundle including premium features and services.",
  "prices": [
    {
      "type": "unit",
      "productId": {
        "Type": "digital"
      },
      "billingInterval": "monthly",
      "unitPricingModel": {
        "pricePerUnit": {
          "value": "59.99"
        }
      },
      "tieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 100,
            "pricePerUnit": {
              "value": "0.10"
            },
            "fixedFee": {
              "value": "5.00"
            }
          }
        ]
      },
      "fixedPricingModel": {
        "pricePerUnit": {
          "value": "24.99"
        },
        "units": 2,
        "total": {
          "value": "49.98"
        }
      },
      "graduatedPercentagePricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 100,
            "fixedFee": {
              "value": "10.00"
            },
            "percentage": {
              "value": "15"
            }
          }
        ]
      },
      "prepaidFixedTieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 50,
            "pricePerUnit": {
              "value": "0.15"
            },
            "fixedFee": {
              "value": "2.00"
            }
          }
        ],
        "units": 100
      },
      "prepaidTieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 75,
            "pricePerUnit": {
              "value": "0.20"
            },
            "fixedFee": {
              "value": "3.00"
            }
          }
        ],
        "units": 50
      },
      "volumePercentagePricingModel": {
        "pricePerUnit": {
          "value": "0.05"
        },
        "percentage": {
          "value": "10"
        },
        "fixedFee": {
          "value": "5.00"
        }
      },
      "discount": {
        "discountType": "percentage",
        "amount": {
          "value": "10.00"
        },
        "periodLength": 6,
        "periodType": "months",
        "endDate": "2009-11-10T23:00:00Z"
      },
      "trialPeriodDays": 30,
      "minimumSpend": {
        "amount": {
          "value": "100.00"
        },
        "period": "monthly"
      },
      "maximumSpend": {
        "amount": {
          "value": "500.00"
        },
        "period": "monthly"
      }
    }
  ]
}
Retrieves a paginated list of all price bundles.

​
Query Parameters

​
page
integer
default:"1"
The page number to retrieve (1-indexed).
​
limit
integer
default:"10"
The number of bundles to return per page. Must be one of: 5, 10, 25, 50, or 100. Values exceeding 100 are capped automatically.
curl "https://api.alguna.io/price-bundles?page=1&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "name": "Premium Bundle",
  "description": "A bundle including premium features and services.",
  "prices": [
    {
      "type": "unit",
      "productId": {
        "Type": "digital"
      },
      "billingInterval": "monthly",
      "unitPricingModel": {
        "pricePerUnit": {
          "value": "59.99"
        }
      },
      "tieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 100,
            "pricePerUnit": {
              "value": "0.10"
            },
            "fixedFee": {
              "value": "5.00"
            }
          }
        ]
      },
      "fixedPricingModel": {
        "pricePerUnit": {
          "value": "24.99"
        },
        "units": 2,
        "total": {
          "value": "49.98"
        }
      },
      "graduatedPercentagePricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 100,
            "fixedFee": {
              "value": "10.00"
            },
            "percentage": {
              "value": "15"
            }
          }
        ]
      },
      "prepaidFixedTieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 50,
            "pricePerUnit": {
              "value": "0.15"
            },
            "fixedFee": {
              "value": "2.00"
            }
          }
        ],
        "units": 100
      },
      "prepaidTieredPricingModel": {
        "tiers": [
          {
            "minUnits": 1,
            "maxUnits": 75,
            "pricePerUnit": {
              "value": "0.20"
            },
            "fixedFee": {
              "value": "3.00"
            }
          }
        ],
        "units": 50
      },
      "volumePercentagePricingModel": {
        "pricePerUnit": {
          "value": "0.05"
        },
        "percentage": {
          "value": "10"
        },
        "fixedFee": {
          "value": "5.00"
        }
      },
      "discount": {
        "discountType": "percentage",
        "amount": {
          "value": "10.00"
        },
        "periodLength": 6,
        "periodType": "months",
        "endDate": "2009-11-10T23:00:00Z"
      },
      "trialPeriodDays": 30,
      "minimumSpend": {
        "amount": {
          "value": "100.00"
        },
        "period": "monthly"
      },
      "maximumSpend": {
        "amount": {
          "value": "500.00"
        },
        "period": "monthly"
      }
    }
  ]
}
​
items
[]Bundle
An array of bundle objects.
​
pageCount
number
The total number of pages available in the response.
​
limit
number
The maximum number of items returned per page.
​
pageCount
integer
Total number of pages available based on the current limit.
​
limit
integer
The number of items per page used for this request.