List Plans

Retrieve a list of all plans.

Use the optional query parameters to filter the results. You can filter the results further by specifying one or more Plan fields as additional query parameters.

Parameters

Request Query Parameters

- ending_before
- The ID of the plan created after the last plan you want to retrieve.
- limit
- The maximum number of plans to return. Range: 1-100.
  10
- starting_after
- The ID of the plan created before the first plan you want to retrieve.

Request Header Parameters

Response Parameters

- active
- Indicates whether the plan is available to be added to a subscription.
- aggregate_usage
- Determines which quantity is used to calculate the pricing. One of the following:
  - max - The maximum reported usage within the billing cycle.
  - sum - The sum of all usage during a billing cycle.
  - last_during_period - The last usage reported within the billing cycle.
  - last_ever - The last usage ever reported, if the latest billing cycles contain no usage at all.
- amount
- The amount to charge, in units of the currency defined in currency.
  Relevant when billing_scheme is set to per_unit.
- billing_scheme
- Describes how to compute the price. One of the following:
  - per_unit - The amount specified in amount is charged for each unit.
  - tiered - The unit pricing is computed using a tiering strategy as defined with the tiers and tiers_mode fields.
- created_at
- Time the plan object was created, in Unix time.
- currency
- Three-letter ISO 4217 code for the currency used in fields that represent monetary amounts.
- id
- Unique ID for this plan.
- interval
- Specifies the units used in defining the billing cycle. One of the following:
  - day
  - week
  - month
  - year
- interval_count
- Number of time intervals in the billing cycle. Integer. See interval.
- metadata
- A JSON object defined by the client. See Metadata.
- nickname
- Brief description of the plan.
- product
- Describes this product in the plan. For details of the fields in the 'product' object, see Create Product.
- tiers
- Defines a tiered pricing structure. Each tier object represents a pricing tier. Relevant when billing_scheme is set to tiered. Contains the following fields:
  - amount - The price for each item in this tier. Decimal number.
  - up_to - The upper volume limit for this tier. Valid values: inf (infinite) or an integer.
  - flat_amount - Extra amount added to the entire tier. Default is 0.
- tiers_mode
- Determines the mode for calculating the total tiered charge. One of the following values:
  - graduated - The total cost at each price tier is calculated separately, then all tier charges are added together.
  - volume - The total cost is calculated as the number of service units multiplied by the applicable tier price.
- transform_usage
- Defines the transformation that is applied to the reported usage before the billed price is computed. The transformation divides the quantity by the divisor specified in divide_by, then rounds up or down according to the setting in round. Relevant when billing_scheme is set to per_unit. Relevant when billing_scheme is set to per_unit. For more information, see Transformation Pricing in Pricing Plans. Contains the following fields:
  divide_by
  Indicates the divisor in the transformation calculation. Integer.
  round
  Indicates whether the reported number of units should be rounded up or down to the next whole quantity specified in divide_by.
- trial_period_days
- The number of days in the customer's free trial period. Integer. Range: 0-730.
- usage_type
- Determines whether the customer is billed when the service is not actually used. Relevant when billing_scheme is set to per_unit. One of the following:
  - metered - The customer is billed only for actual usage.
  - licensed - The customer is billed even if the service is not used.

Code Samples

.NET

using System;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                int limit = 2;

                string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/plans?limit={limit}");

                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const result = await makeRequest(
      'GET',
      '/v1/plans?limit=2'
    );

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

try {
    $object = make_request('get', '/v1/plans?limit=2');
    var_dump($object);
} catch(Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

result = make_request(method='get', path='/v1/plans?limit=2')
pprint(result)

/v1/plans

List Plans

curl -X get
https://sandboxapi.rapyd.net/v1/plans?limit=2
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'

{
  "status": {
    "error_code": "",
    "status": "SUCCESS",
    "message": "",
    "response_code": "",
    "operation_id": "c6cb2a70-0c88-4b78-940c-597b71f13ade"
  },
  "data": [
    {
      "id": "plan_test_1753886809",
      "aggregate_usage": "sum",
      "amount": 0,
      "billing_scheme": "per_unit",
      "created_at": 1753886811,
      "currency": "USD",
      "interval": "month",
      "interval_count": 1,
      "metadata": {},
      "product": {
        "id": "product_8bd3eeef73cb7213415cd1e3797319b0"
      },
      "nickname": "",
      "tiers": [],
      "tiers_mode": "",
      "transform_usage": {
        "divide_by": 0,
        "round": "up"
      },
      "trial_period_days": 0,
      "usage_type": "licensed",
      "active": true
    },
    {
      "id": "plan_a27ad39527e792117ba0ebd164e2e56c",
      "aggregate_usage": "sum",
      "amount": 0,
      "billing_scheme": "tiered",
      "created_at": 1711024403,
      "currency": "USD",
      "interval": "month",
      "interval_count": 1,
      "metadata": {},
      "product": {
        "id": "product_8bd3eeef73cb7213415cd1e3797319b0"
      },
      "nickname": "Cut flower delivery",
      "tiers": [
        {
          "amount": 150,
          "up_to": "inf",
          "flat_amount": 0
        }
      ],
      "tiers_mode": "volume",
      "transform_usage": {
        "divide_by": 0,
        "round": ""
      },
      "trial_period_days": 0,
      "usage_type": "licensed",
      "active": true
    }
  ]
}

In this section:

Documentation