- Invoices now include an
overdueproperty indicating whether the invoice is past due - Added
overduefilter parameter toGET /invoicesto retrieve only overdue invoices
- Batch Upsert: You can now upload multiple usage records at once. Records are upserted based on date, replacing existing records for the same date.
- Breaking Change: The endpoint to create a single usage record has been removed. Use the batch endpoint instead.
A new endpoint to retrieve ARR (Annual Recurring Revenue) waterfall data:
GET /reports/arr-waterfall- Get ARR metrics including new, expansion, contraction, churn, and net revenue changes
You can now create invoices independently of contracts:
POST /invoicesnow supports creating standalone invoices with full item details- Added
send_to_customerparameter to automatically email invoices upon creation
Breaking Change: The API now uses snake_case consistently for all field names and SNAKE_CASE for enum values.
Examples of changed fields:
priceType→price_typeexternalId→external_idcustomerId→customer_id
Update your integration to use the new field names.
Full accounts payable management is now available:
Vendors
GET /vendors- List all vendorsPOST /vendors- Create a vendorGET /vendors/{id}- Retrieve a vendorPUT /vendors/{id}- Update a vendorDELETE /vendors/{id}- Delete a vendor
Bills
GET /bills- List all billsPOST /bills- Create a billGET /bills/{id}- Retrieve a billPUT /bills/{id}- Update a billDELETE /bills/{id}- Delete a bill
All list endpoints now support cursor-based pagination:
- Use
limitparameter to control page size (default varies by endpoint) - Use
cursorparameter to retrieve subsequent pages - Responses include a
paginationobject with acursorfield for the next page
This applies to: /products, /customers, /contracts, /invoices, /vendors, /bills
Breaking Change: All list endpoints now return an object wrapper instead of a raw array.
Before:
[{ "id": "..." }, { "id": "..." }]After:
{
"data": [{ "id": "..." }, { "id": "..." }],
"pagination": { "cursor": "..." }
}Update your integration to access the data property for the list of items.
Added support for usage-based pricing models:
- Products can now have usage-based price types
- Contracts support usage commitments for metered billing
All major entities now support external references, allowing you to link Rillet records to your external systems:
- Customers, Contracts, Invoices, and Products include an
external_referencesarray - Each reference has a
type,id, and optionalurl - Use external references to maintain mappings between Rillet and your CRM, ERP, or other systems
