Documentation Index Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
Use this file to discover all available pages before exploring further.
Facturación
Revisar resúmenes de facturación, facturas, transacciones y operaciones de planes.
Los ejemplos usan el modo de código A2A. MCP expone el mismo modo de código mediante su herramienta execute.
Funciones
billing.current_plan.get
billing.current_plan.get(account_id: str) -> BillingResult
Facturación: billing.current_plan.get.
Propiedad Valor Propiedad Valor Permiso requerido billing.viewAutenticación requerida síModo de ejecución syncCapacidad billing.viewTipo de recurso accountCampo ID del recurso account_idRuta API pública GET /v1/public/accounts/{account_id}/billing/current-plan
Nombre Tipo Requerido account_idstrsí
Campo Tipo Requerido billing_periodstrsí currencystrsí plan_idstrsí plan_namestrsí pricestrsí statusstrsí can_cancel_planboolno can_change_planboolno
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.current_plan.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : true
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.current_plan.get" ,
"status" : "completed" ,
"result" : true
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.current_plan.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : true \n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.current_plan.get \" , \n \" status \" : \" completed \" , \n \" result \" : true \n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}
billing.invoices.list
billing.invoices.list(account_id: str, page?: int, page_size?: int) -> Page[BillingResult]
Facturación: billing.invoices.list.
Propiedad Valor Propiedad Valor Permiso requerido billing.viewAutenticación requerida síModo de ejecución syncCapacidad billing.viewTipo de recurso accountCampo ID del recurso account_idRuta API pública GET /v1/public/accounts/{account_id}/billing/invoices
Nombre Tipo Requerido account_idstrsí pageintno page_sizeintno
Campo Tipo Requerido items[{"amount": str, "currency": str, "date": str, "download_url": str | null, "id": str, "status": str}]sí pageintsí page_sizeintsí totalintsí
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.invoices.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.invoices.list" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.invoices.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : \" <string> \"\n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.invoices.list \" , \n \" status \" : \" completed \" , \n \" result \" : \" <string> \"\n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}
billing.plan.cancel
billing.plan.cancel(account_id: str, cancel_at_period_end?: bool, cancel_immediately?: bool) -> BillingResult
Facturación: billing.plan.cancel.
Propiedad Valor Propiedad Valor Permiso requerido billing.manageAutenticación requerida síModo de ejecución syncCapacidad billing.manageTipo de recurso accountCampo ID del recurso account_idRuta API pública POST /v1/public/accounts/{account_id}/billing/cancel-plan
Nombre Tipo Requerido account_idstrsí cancel_at_period_endboolno cancel_immediatelyboolno
Campo Tipo Requerido statusstrsí account_statusstr | nullno effective_atstr | nullno eligiblebool | nullno previous_plan_idstr | nullno target_plan_idstr | nullno
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.plan.cancel(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , cancel_at_period_end=true, cancel_immediately=true)"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.plan.cancel" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.plan.cancel(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , cancel_at_period_end=true, cancel_immediately=true)"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : \" <string> \"\n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.plan.cancel \" , \n \" status \" : \" completed \" , \n \" result \" : \" <string> \"\n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}
billing.plan.change
billing.plan.change(account_id: str, plan_id: "smtp_per_mailbox" | "smtp_per_proxy", effective_date?: str | null) -> BillingResult
Facturación: billing.plan.change.
Propiedad Valor Propiedad Valor Permiso requerido billing.manageAutenticación requerida síModo de ejecución syncCapacidad billing.manageTipo de recurso accountCampo ID del recurso account_idRuta API pública POST /v1/public/accounts/{account_id}/billing/change-plan
Nombre Tipo Requerido account_idstrsí plan_id"smtp_per_mailbox" | "smtp_per_proxy"sí effective_datestr | nullno
Campo Tipo Requerido statusstrsí account_statusstr | nullno effective_atstr | nullno eligiblebool | nullno previous_plan_idstr | nullno target_plan_idstr | nullno
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.plan.change(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , plan_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , effective_date= \" <string> \" )"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.plan.change" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.plan.change(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , plan_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , effective_date= \" <string> \" )"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : \" <string> \"\n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.plan.change \" , \n \" status \" : \" completed \" , \n \" result \" : \" <string> \"\n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}
billing.transactions.list
billing.transactions.list(account_id: str, page?: int, page_size?: int) -> Page[BillingResult]
Facturación: billing.transactions.list.
Propiedad Valor Propiedad Valor Permiso requerido billing.viewAutenticación requerida síModo de ejecución syncCapacidad billing.viewTipo de recurso accountCampo ID del recurso account_idRuta API pública GET /v1/public/accounts/{account_id}/billing/transactions
Nombre Tipo Requerido account_idstrsí pageintno page_sizeintno
Campo Tipo Requerido pageintsí page_sizeintsí totalintsí items[{"amount": str, "currency": str, "direction": str, "effective_at": str, "status": str, "transaction_id": str, "type": str, "balance_after"?: str | null, "description"?: str | null}]no
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.transactions.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : 123
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.transactions.list" ,
"status" : "completed" ,
"result" : 123
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.transactions.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : 123 \n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.transactions.list \" , \n \" status \" : \" completed \" , \n \" result \" : 123 \n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}
billing.wallet_balance.get
billing.wallet_balance.get(account_id: str) -> BillingResult
Facturación: billing.wallet_balance.get.
Propiedad Valor Propiedad Valor Permiso requerido billing.viewAutenticación requerida síModo de ejecución syncCapacidad billing.viewTipo de recurso accountCampo ID del recurso account_idRuta API pública GET /v1/public/accounts/{account_id}/billing/wallet-balance
Nombre Tipo Requerido account_idstrsí
Campo Tipo Requerido accrued_chargesstrsí balancestrsí currencystrsí net_balancestrsí
Solicitud: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.wallet_balance.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
Respuesta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : {
"accrued_charges" : "<string>" ,
"balance" : "<string>" ,
"currency" : "<string>" ,
"net_balance" : "<string>"
}
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.wallet_balance.get" ,
"status" : "completed" ,
"result" : {
"accrued_charges" : "<string>" ,
"balance" : "<string>" ,
"currency" : "<string>" ,
"net_balance" : "<string>"
}
}
],
"complexity_score" : 1
}
Solicitud: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"method" : "tools/call" ,
"params" : {
"name" : "hybridbox_execute" ,
"arguments" : {
"code" : "billing.wallet_balance.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
}
}
Respuesta: {
"jsonrpc" : "2.0" ,
"id" : "example" ,
"result" : {
"content" : [
{
"type" : "text" ,
"text" : "{ \n \" request_id \" : \" example \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" last_value \" : { \n \" accrued_charges \" : \" <string> \" , \n \" balance \" : \" <string> \" , \n \" currency \" : \" <string> \" , \n \" net_balance \" : \" <string> \"\n } \n }, \n \" responses \" : [ \n { \n \" index \" : 0, \n \" function \" : \" billing.wallet_balance.get \" , \n \" status \" : \" completed \" , \n \" result \" : { \n \" accrued_charges \" : \" <string> \" , \n \" balance \" : \" <string> \" , \n \" currency \" : \" <string> \" , \n \" net_balance \" : \" <string> \"\n } \n } \n ], \n \" complexity_score \" : 1 \n }"
}
],
"isError" : false
}
}