Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Rillet Bills API

The Bills API from Rillet — 2 operation(s) for bills.

Rillet Bills API is one of 28 APIs that Rillet publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Bills. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 2 paths, and defines 21 schemas. It is described by OpenAPI 3.1.0, at version v4.0.

Requests are made against 2 base URLs: https://api.rillet.com, https://sandbox.api.rillet.com.

6 operations 2 paths 21 schemas 1 DELETE2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v4.0
Base URL
https://api.rillet.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Rillet Bills API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 6

Across 2 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Bills 6
GET
/bills
Lists all bills
list-all-bills 6 params → 200default
POST
/bills
Creates a bill
create-a-bill body → 200default
GET
/bills/{bill_id}
Retrieves a bill
retrieve-a-bill 1 param → 200default
PUT
/bills/{bill_id}
Updates a bill
update-a-bill 1 param body → 200default
POST
/bills/{bill_id}
Uploads a document
upload-document 1 param body → 204default
DELETE
/bills/{bill_id}
Deletes a bill
delete-a-bill 1 param → 204default

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are CreateBillRequest (9 properties), UpdateBillRequest (8 properties), BillItemRequest (6 properties), TaxRateWithOptionalAmount (5 properties). Each schema is shown below with its type and property counts.

FieldAssignments
array
ExchangeRate
object
4 properties 4 required
Bill
CreateBillRequest
object
9 properties 5 required
AccountCode
string
The account code found in the Chart of Accounts
ExternalReference
object
For requests, only pre-defined custom IDs are accepted. In responses, an object imported through an integration (e.g. Stripe) would return the provider's objec…
3 properties 2 required
TaxRate
1 required
BillStatus
string
BillItemRequest
object
6 properties 2 required
BillItem
Error
object
4 properties 2 required
PageCursor
string
If defined, a cursor to retrieve the next page.
PageLimit
integer
RoundedMonetaryAmount
object
A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
2 properties 2 required
CountryCode
string
Two-letter country code (ISO 3166-1 alpha-2).
UpdateBillRequest
object
8 properties 5 required
CalendarPeriod
object
2 properties 2 required
CurrencyCode
string
Currency code following ISO-4217
ExpenseTaxRate
TaxRateWithOptionalAmount
object
5 properties 4 required
Pagination
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rillet-bills-api-openapi.yml Raw ↑

Other APIs Rillet publishes across the network.

Rillet API Key API
Rillet Bank accounts API
Rillet Bank Transactions API
Rillet Bill Payments API
Rillet Books periods API
Rillet Charges API
Rillet Chart of Accounts API
Rillet Contract Items API
Rillet Contracts API
Rillet Credit Memos API
Rillet Customer Payments API
Rillet Customers API