Spend Alerts & Billing

The Billing section shows your current plan, usage metrics, and lets you configure spend alerts so you are notified before costs exceed budget.

Usage metrics tracked:

Governed decisions per month — primary billing unit on most plans.
Enrichment calls — some enrichments (content-capture, toxicity-score) are billed separately on high-volume plans.
Storage — decisions and content-capture payloads stored beyond the standard retention window.
API seats — number of unique API keys actively making requests.

Spend alerts:

Go to Settings → Billing → Spend alerts and click Add alert.
Set a threshold (e.g. "notify when monthly governed decisions > 80% of plan limit").
Choose notification channels (email, Slack, webhook).
Click Save.

VeriProof will send an alert at the threshold and again at 100%.

Invoices: Download past invoices as PDF under Settings → Billing → Invoices.

Spend & Usage Alerts

Cost budgets let you define spending or usage thresholds for your Veriproof applications. When a threshold is crossed, Veriproof sends notifications to your configured notification channels (Slack, Microsoft Teams) and/or fires a webhook event.

CustomerAdmin and CustomerBusinessOwner can create and manage budgets. All roles can view budget status.

How Budgets Work

A budget tracks accumulated cost or session volume against a threshold within a measurement window. Veriproof evaluates budgets periodically and fires an alert when a threshold is first exceeded. A resolution event fires when the metric drops back below the threshold.

Measurement Windows

Window	Description
Monthly	Resets at the start of each calendar month (00:00 UTC on the 1st)
Daily	Resets at 00:00 UTC each day

Metric Types

Metric type	Description
`cost_usd`	Estimated USD cost for the period
`session_count`	Number of sessions ingested
`token_count`	Total tokens processed across sessions

Creating a Budget

Open Cost Budgets

Navigate to Settings → Billing → Cost Budgets and click Add Budget.

Configure the budget

Field	Description
Name	A descriptive label for this budget
Application	The application to monitor (or “All applications”)
Metric	What to measure: cost, session count, or token count
Threshold	The value that triggers an alert
Window	Monthly or daily
Alert at (%)	Optional: trigger at a percentage of the threshold before it’s fully reached (e.g. alert at 80% to get an early warning)

Add notification destinations

Select one or more notification channels (Slack / Teams) to receive the alert message.

Save

Click Save budget. The budget starts tracking from the beginning of the current window.

Viewing Budget Status

The Settings → Billing → Cost Budgets page shows all budgets with their current utilization:

Column	Description
Name	Budget name
Application	Scope
Metric	Cost, sessions, or tokens
Threshold	Configured limit
Current	Current period value
Utilization	Percentage of threshold consumed (progress bar)
Status	OK / Warning / Critical / Triggered
Next reset	When the measurement window resets

Editing and Deleting Budgets

To edit a budget: click its name to open the budget detail, then click Edit.

To delete a budget: open the budget detail and click Delete. Deletion stops all future alerts from this budget and cannot be undone.

API


GET    /v1/cost/budgets               # List all budgets
POST   /v1/cost/budgets               # Create a budget
PUT    /v1/cost/budgets/{budgetId}    # Update a budget
DELETE /v1/cost/budgets/{budgetId}    # Delete a budget

Create a budget via API


POST /v1/cost/budgets
Content-Type: application/json
 
{
  "name": "Production — monthly cost cap",
  "applicationId": "app_xyz789",
  "metricType": "cost_usd",
  "threshold": 500.00,
  "window": "monthly",
  "alertAtPercent": 80,
  "notificationChannelIds": ["chan_01H5..."],
  "webhookEnabled": true
}

Notification Channels

Notification channels are the Slack workspaces or Microsoft Teams tenants that receive formatted alert messages.

Creating a Notification Channel

Navigate to Settings → Integrations → Notification Channels and click Add channel.
Select Slack or Microsoft Teams.
For Slack: authorize the Veriproof app in your Slack workspace and select the target channel.
For Teams: provide an Incoming Webhook URL for the Teams channel.
Click Send test message to verify the channel is working.
Save the channel.

Notification Channel API


GET    /v1/notification-channels                         # List channels
POST   /v1/notification-channels                         # Create a channel
GET    /v1/notification-channels/{channelId}             # Get a single channel
PUT    /v1/notification-channels/{channelId}             # Update a channel
DELETE /v1/notification-channels/{channelId}             # Remove a channel
POST   /v1/notification-channels/{channelId}/test        # Send a test message

Alert Message Format

Triggered budget alerts are sent as a formatted message:

[Veriproof Alert] Production — monthly cost cap
Threshold exceeded: $523.40 / $500.00 (104.7%)
Application: production-app
Window: Monthly (resets 2025-07-01)
View in portal →

Resolution messages are sent when the metric drops back below threshold at the end of a window or after a budget edit.

Alert Rules (Advanced)

The budget system described above is designed for simple cost and volume thresholds. For more complex alert logic (e.g. “alert when refusal rate exceeds 25% over a sliding 1-hour window”), use the Alert Rules system available in Alerts → Alert Rules in the Customer Portal. Alert rules support:

Metric-based thresholds on any governance or quality dimension
Sliding or fixed windows
Multi-condition AND/OR logic
The same notification channel and webhook delivery infrastructure

See the Monitoring & Alerting guide for full alert rule documentation.