Manage and set up budget notifications for your services

Set up and manage budget notifications to monitor your costs. You can configure a threshold level for when you want to be alerted and which email address should receive the notifications. This helps you keep track of your expenses and avoid unexpected costs.

Billing & Payments Billing

Context

Used in the dashboard

/cost-management

Related endpoints

POST /api/cost-management/budget Manage and set up budgets for your service costs

Headers

Accept Example

Content-Type Example

Responses

200

data object required

data.active boolean required · Example: true

data.alert_threshold integer required · Example: 80

data.annual_budget string · nullable required · Example: null

Nullable: may be null when not applicable.

data.email string · nullable required · Example: null

Nullable: may be null when not applicable.

data.monthly_budget string · nullable required · Example: null

Nullable: may be null when not applicable.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/cost-management/budget

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/cost-management/budget" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "monthly_budget": null,
    "annual_budget": null,
    "alert_threshold": 80,
    "email": null,
    "active": true
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "active": {
          "type": "boolean"
        },
        "alert_threshold": {
          "type": "integer"
        },
        "annual_budget": {
          "type": "string",
          "nullable": true
        },
        "email": {
          "type": "string",
          "nullable": true
        },
        "monthly_budget": {
          "type": "string",
          "nullable": true
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}