Why upgrade to BILL v3?

BILL v3 represents a ground-up modernization of our developer platform. With BILL v3, you get access to newer capabilities, modern workflows, and a stronger developer experience as compared to v2.

True REST architecture

BILL v3 embraces industry-standard HTTP methods (POST, GET, PATCH, PUT, and DELETE) and the API structure is built intuitively around BILL core objects and resources.

With BILL v3, interacting with BILL objects is predictable. For example, creating a vendor is a simple POST to /v3/vendors, and modifying a vendor is a PATCH to /v3/vendors/{vendorId}. This eliminates code duplication in your solution.

Standard HTTP response status & explicit error objects

In BILL v3, HTTP codes are correctly mapped to the response type. When a request encounters an issue, v3 delivers a structured JSON error array with explicit error objects.

👍

4XX / 5XX responses

Each response is an array of objects. Each object includes the timestamp, code, severity, category, and message fields.

You can build robust retry workflows based on extensive metadata information. In addition, you can surface human-readable error messages in your solutions without any payload guesswork.

Streamlined responses & cleaner data models

BILL v2 payloads are often verbose, flat, and heavily reliant on strings. BILL v3 leverages native JSON types (such as booleans instead of string flags). BILL v3 also adopts nested object mapping (such as address fields cleanly encapsulated in a standard address {} object).

With BILL v3, you take advantage of a lower memory footprint in your solution, and cleaner data modeling in your database schema.

Workflow consolidation

BILL v3 combines dependent actions into atomic, single-operation endpoints.

For example, you can create a vendor and securely add their bank account information with a single POST request. In addition, you can create an invoice, and immediately send it to the customer with a single API operations.

Improved business logic mapping

BILL v3 handles workflows that aligns directly with actual business operations you experience in the BILL web app.

For example, the bill approvals architecture in v3 is rewritten to map directly to the actual experience in the BILL web app. In addition, v3 provides native support for programmatically adding organization funding accounts.

BILL v3 exclusive features

BILL v3 serves as the foundation for modern BILL products. These capabilities are not available with BILL v2. This is NOT an exhaustive list.

👍

Feature parity & roadmap commitment

BILL v3 does not yet have 100% feature parity with capabilities found in v2. BILL's top priority is to close these remaining gaps and achieving total functional parity.