Orb now allows you to anchor your billing cycles to a custom date. Previously, you were able to specify the day of the month on which billing cycles were anchored. Now, you're able to specify a full date.
For example, a quarterly subscription anchored on March 16, 2024 with a start date of October 10, 2023 and an end date of March 16, 2024 would have the following billing periods: October 10, 2023 - December 16, 2023, December 16, 2023 - March 16, 2024.
Orb now supports specifying a custom billing cadence or one-time service period. Previously, prices could only recur monthly, quarterly, semi-annually, or annually. Now you're able to specify a custom duration in days or months. You can also now specify a custom service period duration for one-time prices, which determines the duration of the line item.
Orb's API now supports the dry running of requests. Dry running API requests allows you to validate the correctness of a request without making any actual changes to the system. This feature is particularly useful for ensuring that the request does not contain any errors and for previewing the potential response of a mutation before committing it.
Dry-running a request is as simple as including a “Dry-Run” header with a value of “True”, as shown below:
curl --request POST \ --url https://api.withorb.com/v1/subscriptions \ --header 'Dry-Run: True' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer null' \ --header 'Content-Type: application/json'
More information can be found in our documentation.
Orb now allows adding and removing prices during subscription creation and plan change. Previously, plan overrides only allowed prices to be modified. This allows the creation of a wide variety of custom plans using a small number of template plans, without having to construct the new plans from scratch. It also makes it easy to create add-ons to existing plans and subscriptions.
See the docs here: Subscription price overrides
We have introduced a new API endpoint, Update Alert, that allows you to update the thresholds of an existing alert. This functionality mirrors our UI's existing edit alert flow for credit balance, usage, and cost alerts.
To learn more about Orb's alerting features, read more in our documentation.
Orb's backfill feature allows you to amend or replace events in a given time frame. This can be useful in cases where revising events is necessary, such as in the case of incorrect event reporting.
Backfills now support filtering across time ranges and with computed properties, which enables the expressiveness of SQL when replacing events. Using the `deprecation_filter` field requires `replace_existing_events` to be true and the filter must be an expression that is coercible to a boolean - for more information, see the docs here.
Orb now supports adding negative line items when editing an invoice in the Orb webapp! If you want to credit a customer's invoice or correct a mistake on an invoice, creating a negative line item in invoice edits is an easy way to ensure the customer's invoice is issued correctly and without confusion.
Orb's data exports feature now supports invoice billings broken down by line item through the Invoice Line Item Billing resource. This information can be used to power use cases like: calculating precise discount amounts and breaking down billed amounts by price.
For customers with data exports included in your plan, this resource will automatically be included in the list of resources exported to your data destination.
This resource is a powerful way to understand and track the individual line item values for invoices that have been billed. As opposed to the Daily Line Item Revenue resource, this resource avoids the need to filter to line items for invoices that have yet to be billed and aggregates line item amounts into a single value instead of one value per day.
For more information about this resource, please check out our documentation. If you'd like to learn more about the data exports product generally, please feel free to look through our docs or reach out to the Orb team.
Over the last two weeks, we made significant performance improvements to the Orb dashboard. In particular, the customer list, the customer detail page, and the invoice list should now load faster. You can expect additional performance improvements in the weeks and months to come.
Metadata is a key-value object that lets you store customizable information on Orb core resources. In addition to Customer, Subscription, and Plan, you can now update metadata on the Price and Invoice objects through two newly-released endpoints. Learn more about them here: