Skip to main content
GET
/
api
/
v1
/
billing
/
plan-limits
Plan Limits
curl --request GET \
  --url https://api.example.com/api/v1/billing/plan-limits

​
Headers

HeaderValor
AuthorizationBearer {token}

​
Response (200)

{
  "plan": "enterprise",
  "limits": {
    "max_projects": 999999,
    "max_cli_tools": 999999,
    "max_members": 999999,
    "skills_premium": true,
    "skills_parallel": true,
    "audit_cloud": true
  },
  "usage": {
    "projects": 3,
    "members": 1
  }
}

​
Get Subscription

GET /api/v1/billing/subscription

​
Response (200)

{
  "plan": "premium",
  "status": "active",
  "stripe_subscription_id": "sub_...",
  "current_period_end": "2026-05-04T12:00:00"
}

​
Create Checkout

POST /api/v1/billing/create-checkout
Crea una sesión de Stripe Checkout para hacer upgrade al plan Premium.

​
Request Body

{
  "success_url": "https://app.nexus.dev/dashboard/billing?session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://app.nexus.dev/dashboard/billing"
}

​
Response (200)

{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_...",
  "session_id": "cs_..."
}

​
Confirm Subscription

POST /api/v1/billing/confirm-subscription
Confirma el pago después de regresar de Stripe Checkout.

​
Request Body

{
  "session_id": "cs_..."
}

​
Response (200)

{
  "plan": "premium",
  "status": "active",
  "message": "Suscripción activada exitosamente"
}

​
Create Portal

POST /api/v1/billing/create-portal
Genera un enlace al portal de facturación de Stripe donde el usuario puede gestionar su suscripción, actualizar método de pago, o cancelar.

​
Request Body

{
  "return_url": "https://app.nexus.dev/dashboard/billing"
}

​
Response (200)

{
  "portal_url": "https://billing.stripe.com/p/session/..."
}