Create a rate plan that is associated with an API product in an organization.
Using rate plans, API product owners can monetize their API products by configuring one or more of the following: - Billing frequency - Initial setup fees for using an API product - Payment funding model (postpaid only) - Fixed recurring or consumption-based charges for using an API product - Revenue sharing with developer partners
An API product can have multiple rate plans associated with it but only one rate plan can be active at any point of time.
**Note: From the developer's perspective, they purchase API products not rate plans.
HTTP request
POST https://apigee.googleapis.com/v1/{parent=organizations/*/apiproducts/*}/rateplans
Required. Name of the API product that is associated with the rate plan. Use the following structure in your request: organizations/{org}/apiproducts/{apiproduct}
If the API Product resource has the space attribute set, IAM permissions are checked against the Space resource path. To learn more, read the Apigee Spaces Overview.
Authorization requires the following IAM permission on the specified resource parent:
apigee.rateplans.create
Request body
The request body contains an instance of RatePlan.
Response body
If successful, the response body contains a newly created instance of RatePlan.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-18 UTC."],[[["Rate plans allow API product owners to monetize their APIs by configuring billing frequency, setup fees, payment models, recurring or consumption-based charges, and revenue sharing."],["An API product can have multiple rate plans, but only one can be active at a time, and developers purchase API products, not rate plans."],["The `POST` request to create a rate plan is sent to a URL utilizing gRPC Transcoding syntax: `https://apigee.googleapis.com/v1/{parent=organizations/*/apiproducts/*}/rateplans`."],["The `parent` path parameter in the request URL specifies the associated API product in the format `organizations/{org}/apiproducts/{apiproduct}`, requiring `apigee.rateplans.create` IAM permission."],["Creating a rate plan requires the OAuth scope `https://www.googleapis.com/auth/cloud-platform`."]]],[]]
