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.
Fatturazione
Rivedere riepiloghi di fatturazione, fatture, transazioni e operazioni sui piani.
Gli esempi usano la modalità codice A2A. MCP espone la stessa modalità codice tramite lo strumento execute.
Funzioni
billing.current_plan.get
billing.current_plan.get(account_id: str) -> BillingResult
Fatturazione: billing.current_plan.get.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.viewAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.viewTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica GET /v1/public/accounts/{account_id}/billing/current-plan
Nome Tipo Obbligatorio account_idstrsì
Campo Tipo Obbligatorio billing_periodstrsì currencystrsì plan_idstrsì plan_namestrsì pricestrsì statusstrsì can_cancel_planboolno can_change_planboolno
Richiesta: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.current_plan.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
Risposta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : true
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.current_plan.get" ,
"status" : "completed" ,
"result" : true
}
],
"complexity_score" : 1
}
Richiesta: {
"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 \" )"
}
}
}
Risposta: {
"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]
Fatturazione: billing.invoices.list.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.viewAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.viewTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica GET /v1/public/accounts/{account_id}/billing/invoices
Nome Tipo Obbligatorio account_idstrsì pageintno page_sizeintno
Campo Tipo Obbligatorio items[{"amount": str, "currency": str, "date": str, "download_url": str | null, "id": str, "status": str}]sì pageintsì page_sizeintsì totalintsì
Richiesta: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.invoices.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
Risposta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.invoices.list" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Richiesta: {
"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)"
}
}
}
Risposta: {
"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
Fatturazione: billing.plan.cancel.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.manageAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.manageTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica POST /v1/public/accounts/{account_id}/billing/cancel-plan
Nome Tipo Obbligatorio account_idstrsì cancel_at_period_endboolno cancel_immediatelyboolno
Campo Tipo Obbligatorio statusstrsì account_statusstr | nullno effective_atstr | nullno eligiblebool | nullno previous_plan_idstr | nullno target_plan_idstr | nullno
Richiesta: {
"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)"
}
Risposta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.plan.cancel" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Richiesta: {
"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)"
}
}
}
Risposta: {
"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
Fatturazione: billing.plan.change.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.manageAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.manageTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica POST /v1/public/accounts/{account_id}/billing/change-plan
Nome Tipo Obbligatorio account_idstrsì plan_id"smtp_per_mailbox" | "smtp_per_proxy"sì effective_datestr | nullno
Campo Tipo Obbligatorio statusstrsì account_statusstr | nullno effective_atstr | nullno eligiblebool | nullno previous_plan_idstr | nullno target_plan_idstr | nullno
Richiesta: {
"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> \" )"
}
Risposta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : "<string>"
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.plan.change" ,
"status" : "completed" ,
"result" : "<string>"
}
],
"complexity_score" : 1
}
Richiesta: {
"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> \" )"
}
}
}
Risposta: {
"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]
Fatturazione: billing.transactions.list.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.viewAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.viewTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica GET /v1/public/accounts/{account_id}/billing/transactions
Nome Tipo Obbligatorio account_idstrsì pageintno page_sizeintno
Campo Tipo Obbligatorio 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
Richiesta: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.transactions.list(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" , page=123, page_size=123)"
}
Risposta: {
"request_id" : "example" ,
"status" : "completed" ,
"result" : {
"last_value" : 123
},
"responses" : [
{
"index" : 0 ,
"function" : "billing.transactions.list" ,
"status" : "completed" ,
"result" : 123
}
],
"complexity_score" : 1
}
Richiesta: {
"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)"
}
}
}
Risposta: {
"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
Fatturazione: billing.wallet_balance.get.
Proprietà Valore Proprietà Valore Autorizzazione richiesta billing.viewAutenticazione richiesta sìModalità di esecuzione syncCapacità billing.viewTipo di risorsa accountCampo ID risorsa account_idRoute API pubblica GET /v1/public/accounts/{account_id}/billing/wallet-balance
Nome Tipo Obbligatorio account_idstrsì
Campo Tipo Obbligatorio accrued_chargesstrsì balancestrsì currencystrsì net_balancestrsì
Richiesta: {
"request_id" : "example" ,
"session_id" : "session_123" ,
"code" : "billing.wallet_balance.get(account_id= \" 3c90c3cc-0d44-4b50-8888-8dd25736052a \" )"
}
Risposta: {
"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
}
Richiesta: {
"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 \" )"
}
}
}
Risposta: {
"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
}
}