API documentation
Alert
Credit
- GETFetch credit block
- DELDelete credit block
- GETList invoices for credit block
- GETFetch customer credit balance by external customer id
- GETFetch customer credits ledger by external ID
- POSTCreate ledger entry by external ID
- GETList top-ups by external ID
- POSTCreate top-up by external ID
- DELDeactivate top-up by external ID
- GETFetch customer credit balance
- GETFetch customer credits ledger
- POSTCreate ledger entry
- GETList top-ups
- POSTCreate top-up
- DELDeactivate top-up
Customer
- GETList customers
- POSTCreate customer
- GETFetch customer by external ID
- PUTUpdate customer by external ID
- GETFetch customer costs by external ID
- POSTUpdate payment methods from payment provider
- GETFetch customer
- PUTUpdate customer
- DELDelete customer
- GETList balance transactions
- POSTCreate customer balance transaction
- GETFetch customer costs
- POSTUpdate payment methods from payment provider
Dimensional Price Group
Event
Invoice
- POSTCreate invoice line item
- GETList invoices
- POSTCreate a one-off invoice
- GETList invoices summary
- POSTIssue invoice summary
- GETFetch upcoming invoice
- GETFetch invoice
- PUTUpdate invoice
- DELDelete invoice line item
- POSTIssue invoice
- POSTMark invoice as paid
- POSTPay invoice
- POSTRegenerate invoice PDF
- POSTRegenerate receipt PDF
- POSTVoid invoice
License
Availability
Plan
- GETList plans
- POSTCreate plan
- GETFetch plan by external ID
- PUTUpdate plan by external ID
- POSTSet plan version as default by external ID
- POSTCreate plan version by external ID
- GETFetch plan version by external ID
- GETFetch plan
- PUTUpdate plan by id
- GETList migrations
- GETFetch migration
- POSTCancel migration
- POSTSet plan version as default
- POSTCreate plan version
- GETFetch plan version
Price
Subscription Change
Subscription
- GETList subscriptions
- POSTCreate subscription
- GETFetch subscription
- PUTUpdate subscription
- POSTCancel subscription
- GETFetch subscription costs
- POSTRedeem Coupon
- GETFetch subscription schedule
- POSTSchedule plan change
- POSTTrigger phase
- POSTUnschedule subscription cancellation
- POSTUnschedule fixed fee quantity updates
- POSTUnschedule plan change
- POSTUpdate price quantity
- POSTUpdate trial for subscription
- GETFetch subscription usage
Price interval
curl --request POST \
--url https://api.withorb.com/v1/alerts/customer_id/{customer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "credit_balance_depleted",
"currency": "<string>",
"thresholds": [
{
"value": 123
}
]
}
'{
"id": "<string>",
"type": "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\"",
"created_at": "2023-11-07T05:31:56Z",
"enabled": true,
"thresholds": [
{
"value": 123
}
],
"customer": {
"id": "<string>",
"external_customer_id": "<string>"
},
"plan": {
"id": "m2t5akQeh2obwxeU",
"external_plan_id": "m2t5akQeh2obwxeU",
"name": "Example plan",
"plan_version": "<string>"
},
"subscription": {
"id": "<string>"
},
"metric": {
"id": "<string>"
},
"currency": "<string>",
"license_type": {
"id": "<string>"
},
"grouping_keys": [
"<string>"
],
"balance_alert_status": [
{
"threshold_value": 123,
"in_alert": true
}
]
}Create customer alert
This endpoint creates a new alert to monitor a customer’s credit balance. There are three types of alerts that can be scoped to
customers: credit_balance_depleted, credit_balance_dropped, and credit_balance_recovered. Customers can have a maximum
of one of each type of alert per credit balance currency.
credit_balance_dropped alerts require a list of thresholds to be provided while credit_balance_depleted
and credit_balance_recovered alerts do not require thresholds.
curl --request POST \
--url https://api.withorb.com/v1/alerts/customer_id/{customer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "credit_balance_depleted",
"currency": "<string>",
"thresholds": [
{
"value": 123
}
]
}
'{
"id": "<string>",
"type": "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\"",
"created_at": "2023-11-07T05:31:56Z",
"enabled": true,
"thresholds": [
{
"value": 123
}
],
"customer": {
"id": "<string>",
"external_customer_id": "<string>"
},
"plan": {
"id": "m2t5akQeh2obwxeU",
"external_plan_id": "m2t5akQeh2obwxeU",
"name": "Example plan",
"plan_version": "<string>"
},
"subscription": {
"id": "<string>"
},
"metric": {
"id": "<string>"
},
"currency": "<string>",
"license_type": {
"id": "<string>"
},
"grouping_keys": [
"<string>"
],
"balance_alert_status": [
{
"threshold_value": 123,
"in_alert": true
}
]
}Authorizations
API Keys can be issued in the Orb's web application.
Path Parameters
Body
The type of alert to create. This must be a valid alert type.
credit_balance_depleted, credit_balance_dropped, credit_balance_recovered The case sensitive currency or custom pricing unit to use for this alert.
The thresholds that define the values at which the alert will be triggered.
Show child attributes
Show child attributes
Response
Created
Alerts within Orb monitor spending, usage, or credit balance and trigger webhooks when a threshold is exceeded.
Alerts created through the API can be scoped to either customers or subscriptions.
Also referred to as alert_id in this documentation.
"XuxCbt7x9L82yyeF"
The type of alert. This must be a valid alert type.
credit_balance_depleted, credit_balance_dropped, credit_balance_recovered "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\""
The creation time of the resource in Orb.
Whether the alert is enabled or disabled.
The thresholds that define the conditions under which the alert will be triggered.
Show child attributes
Show child attributes
The customer the alert applies to.
Show child attributes
Show child attributes
The plan the alert applies to.
Show child attributes
Show child attributes
The subscription the alert applies to.
Show child attributes
Show child attributes
The metric the alert applies to.
Show child attributes
Show child attributes
The name of the currency the credit balance or invoice cost is denominated in.
The license type the alert applies to. Only present for license alerts.
Show child attributes
Show child attributes
The property keys to group cost alerts by. Only present for cost alerts with grouping enabled.
The current status of the alert. This field is only present for credit balance alerts.
Show child attributes
Show child attributes
Was this page helpful?