Cobrança
Listar planos
Lista os planos à venda, com preço, memória, vCPU, limites e recursos, e os períodos de cobrança com seus descontos.
GET
/
v1
/
plans
Listar planos
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
}
}
]
}
}
Retorna os planos que você pode comprar hoje, com o preço, a memória, a vCPU, os limites e os recursos de cada um, e os períodos de cobrança com seus descontos. A rota é pública: não precisa de chave de API nem de sessão, então dá para chamá-la antes de a conta existir. Ela é limitada a 20 requisições por minuto por endereço IP, e a resposta pode ficar em cache por 10 minutos.
Use-a para montar uma tabela de preços ou para validar os nomes de plano que você envia em Criar pedido. O valor que a conta realmente paga vem de Cotar pedido, porque pode incluir um cupom ou um preço mantido de um plano anterior.
Resposta
object
Mostrar Toggle object
Mostrar Toggle object
object[]
object[]
Os planos à venda, do menor para o maior.
Mostrar Toggle object
Mostrar Toggle object
string
O nome do plano, o valor que você envia em
plan ao criar um pedido, como starter-1, pro-4, business-12 ou enterprise-32.string | null
starter, pro, business ou enterprise. null para um plano que não é mais vendido.boolean
true para um plano que não é mais vendido.integer
A memória que a conta pode alocar entre suas aplicações e bancos de dados, em MB.
number
O máximo de vCPU que uma aplicação pode usar no plano.
number
O preço mensal em BRL, sem nenhum desconto de período. O preço de um período é
price vezes months vezes (1 - discount_percent / 100), arredondado para o centavo.string[]
pix e card.object
Mostrar Toggle object
Mostrar Toggle object
integer
Deploys por hora.
integer
Requisições de API por minuto com uma chave de API.
integer
Requisições de API por dia com uma chave de API.
integer
Domínios personalizados por aplicação.
integer
Portas além da 80 que uma aplicação com domínios pode servir.
integer
Backups manuais por conta por dia.
integer
Membros de um workspace.
integer
Funções personalizadas de um workspace.
integer
Versões guardadas para rollback.
integer
Dias em que uma versão é guardada.
integer
Imagens Docker personalizadas.
0 quando o plano não tem.object
Limites do Blob Storage:
quota_bytes, max_rules, max_custom_domains, image_transformations_per_month e s3_requests_per_10s.object
Booleanos do que o plano inclui:
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 e 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
}
}
]
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
RATE_LIMIT_EXCEEDED: Mais de 20 requisições em um minuto do mesmo endereço IP (429).details.retry_afterinforma a espera.INTERNAL_SERVER_ERROR: Ocorreu um erro inesperado no servidor.
Última modificação em 1 de novembro de 2026
⌘I
Listar planos
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
}
}
]
}
}