Billing
List Plans
Lists the plans on sale, with price, memory, vCPU, limits and features, and the billing periods with their discounts.
GET
/
v1
/
plans
List Plans
curl --request GET \
--url https://api.vertracloud.app/v1/plans \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/plans', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/plans"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/plans"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"cycles": [
{ "months": 1, "discount_percent": 0 },
{ "months": 3, "discount_percent": 10 },
{ "months": 6, "discount_percent": 15 },
{ "months": 12, "discount_percent": 25 }
],
"plans": [
{
"name": "starter-1",
"family": "starter",
"legacy": false,
"memory_mb": 1024,
"max_vcpus_per_app": 1,
"price": 7.7,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 20,
"requests_per_minute": 120,
"requests_per_day": 43200,
"max_domains": 0,
"max_domain_ports": 5,
"manual_backups_per_day": 8,
"workspace_members": 0,
"workspace_roles": 0,
"release_versions": 3,
"release_retention_days": 7,
"max_custom_images": 0,
"blob": {
"quota_bytes": 10737418240,
"max_rules": 5,
"max_custom_domains": 0,
"image_transformations_per_month": 0,
"s3_requests_per_10s": 100
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": false,
"custom_domain": false,
"custom_subdomain": true,
"file_manager": true,
"database_manager": false,
"auto_deploy": true,
"rollback": true,
"auto_rollback": false,
"zero_downtime": false,
"delete_snapshot": true,
"powered_by_badge": true,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
},
{
"name": "pro-4",
"family": "pro",
"legacy": false,
"memory_mb": 4096,
"max_vcpus_per_app": 4,
"price": 20.9,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 60,
"requests_per_minute": 300,
"requests_per_day": 172800,
"max_domains": 2,
"max_domain_ports": 5,
"manual_backups_per_day": 32,
"workspace_members": 5,
"workspace_roles": 4,
"release_versions": 15,
"release_retention_days": 30,
"max_custom_images": 2,
"blob": {
"quota_bytes": 53687091200,
"max_rules": 5,
"max_custom_domains": 1,
"image_transformations_per_month": 1500,
"s3_requests_per_10s": 400
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": true,
"custom_domain": true,
"custom_subdomain": true,
"file_manager": true,
"database_manager": true,
"auto_deploy": true,
"rollback": true,
"auto_rollback": true,
"zero_downtime": true,
"delete_snapshot": true,
"powered_by_badge": false,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
}
]
}
}
Returns the plans you can buy today, with the price, memory, vCPU, limits and features of each one, and the billing periods with their discounts. The route is public: it needs no API key or session, so you can call it before an account exists. It is limited to 20 requests per minute per IP address, and the response can be cached for 10 minutes.
Use it to build a pricing table or to validate the plan names you send to Create Order. The amount an account is actually charged comes from Quote Order, because it can include a coupon or a price kept from a previous plan.
Response
object
Show Toggle object
Show Toggle object
object[]
object[]
The plans on sale, from the smallest to the largest.
Show Toggle object
Show Toggle object
string
The plan name, the value you send as
plan when you create an order, such as starter-1, pro-4, business-12 or enterprise-32.string | null
starter, pro, business or enterprise. null for a plan that is no longer sold.boolean
true for a plan that is no longer sold.integer
The memory the account can allocate across its applications and databases, in MB.
number
The most vCPU one application can use on the plan.
number
The monthly price in BRL, without any period discount. The price of a period is
price times months times (1 - discount_percent / 100), rounded to the cent.string[]
pix and card.object
Show Toggle object
Show Toggle object
integer
Deploys per hour.
integer
API requests per minute with an API key.
integer
API requests per day with an API key.
integer
Custom domains per application.
integer
Ports besides 80 that an application with domains can serve.
integer
Manual backups per account per day.
integer
Members of a workspace.
integer
Custom roles of a workspace.
integer
Versions kept for rollback.
integer
Days a version is kept.
integer
Custom Docker images.
0 when the plan has none.object
Blob Storage limits:
quota_bytes, max_rules, max_custom_domains, image_transformations_per_month and s3_requests_per_10s.object
Booleans for what the plan includes:
web_published, daily_backups, create_backup, advanced_metrics, create_workspace, custom_domain, custom_subdomain, file_manager, database_manager, auto_deploy, rollback, auto_rollback, zero_downtime, delete_snapshot, powered_by_badge, blob_metadata, blob_share_password, blob_unlimited_upload_rate, blob_no_cache and blob_short_expiration.{
"response": {
"cycles": [
{ "months": 1, "discount_percent": 0 },
{ "months": 3, "discount_percent": 10 },
{ "months": 6, "discount_percent": 15 },
{ "months": 12, "discount_percent": 25 }
],
"plans": [
{
"name": "starter-1",
"family": "starter",
"legacy": false,
"memory_mb": 1024,
"max_vcpus_per_app": 1,
"price": 7.7,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 20,
"requests_per_minute": 120,
"requests_per_day": 43200,
"max_domains": 0,
"max_domain_ports": 5,
"manual_backups_per_day": 8,
"workspace_members": 0,
"workspace_roles": 0,
"release_versions": 3,
"release_retention_days": 7,
"max_custom_images": 0,
"blob": {
"quota_bytes": 10737418240,
"max_rules": 5,
"max_custom_domains": 0,
"image_transformations_per_month": 0,
"s3_requests_per_10s": 100
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": false,
"custom_domain": false,
"custom_subdomain": true,
"file_manager": true,
"database_manager": false,
"auto_deploy": true,
"rollback": true,
"auto_rollback": false,
"zero_downtime": false,
"delete_snapshot": true,
"powered_by_badge": true,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
},
{
"name": "pro-4",
"family": "pro",
"legacy": false,
"memory_mb": 4096,
"max_vcpus_per_app": 4,
"price": 20.9,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 60,
"requests_per_minute": 300,
"requests_per_day": 172800,
"max_domains": 2,
"max_domain_ports": 5,
"manual_backups_per_day": 32,
"workspace_members": 5,
"workspace_roles": 4,
"release_versions": 15,
"release_retention_days": 30,
"max_custom_images": 2,
"blob": {
"quota_bytes": 53687091200,
"max_rules": 5,
"max_custom_domains": 1,
"image_transformations_per_month": 1500,
"s3_requests_per_10s": 400
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": true,
"custom_domain": true,
"custom_subdomain": true,
"file_manager": true,
"database_manager": true,
"auto_deploy": true,
"rollback": true,
"auto_rollback": true,
"zero_downtime": true,
"delete_snapshot": true,
"powered_by_badge": false,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
}
]
}
}
Error Responses
string
The error code indicating the reason for failure. Possible values:
RATE_LIMIT_EXCEEDED: More than 20 requests in a minute from the same IP address (429).details.retry_aftergives the wait.INTERNAL_SERVER_ERROR: An unexpected server error occurred.
Last modified on November 1, 2026
⌘I
List Plans
curl --request GET \
--url https://api.vertracloud.app/v1/plans \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/plans', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/plans"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/plans"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"cycles": [
{ "months": 1, "discount_percent": 0 },
{ "months": 3, "discount_percent": 10 },
{ "months": 6, "discount_percent": 15 },
{ "months": 12, "discount_percent": 25 }
],
"plans": [
{
"name": "starter-1",
"family": "starter",
"legacy": false,
"memory_mb": 1024,
"max_vcpus_per_app": 1,
"price": 7.7,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 20,
"requests_per_minute": 120,
"requests_per_day": 43200,
"max_domains": 0,
"max_domain_ports": 5,
"manual_backups_per_day": 8,
"workspace_members": 0,
"workspace_roles": 0,
"release_versions": 3,
"release_retention_days": 7,
"max_custom_images": 0,
"blob": {
"quota_bytes": 10737418240,
"max_rules": 5,
"max_custom_domains": 0,
"image_transformations_per_month": 0,
"s3_requests_per_10s": 100
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": false,
"custom_domain": false,
"custom_subdomain": true,
"file_manager": true,
"database_manager": false,
"auto_deploy": true,
"rollback": true,
"auto_rollback": false,
"zero_downtime": false,
"delete_snapshot": true,
"powered_by_badge": true,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
},
{
"name": "pro-4",
"family": "pro",
"legacy": false,
"memory_mb": 4096,
"max_vcpus_per_app": 4,
"price": 20.9,
"payment_methods": ["pix", "card"],
"limits": {
"deploys_per_hour": 60,
"requests_per_minute": 300,
"requests_per_day": 172800,
"max_domains": 2,
"max_domain_ports": 5,
"manual_backups_per_day": 32,
"workspace_members": 5,
"workspace_roles": 4,
"release_versions": 15,
"release_retention_days": 30,
"max_custom_images": 2,
"blob": {
"quota_bytes": 53687091200,
"max_rules": 5,
"max_custom_domains": 1,
"image_transformations_per_month": 1500,
"s3_requests_per_10s": 400
}
},
"features": {
"web_published": true,
"daily_backups": true,
"create_backup": true,
"advanced_metrics": true,
"create_workspace": true,
"custom_domain": true,
"custom_subdomain": true,
"file_manager": true,
"database_manager": true,
"auto_deploy": true,
"rollback": true,
"auto_rollback": true,
"zero_downtime": true,
"delete_snapshot": true,
"powered_by_badge": false,
"blob_metadata": false,
"blob_share_password": false,
"blob_unlimited_upload_rate": false,
"blob_no_cache": false,
"blob_short_expiration": false
}
}
]
}
}