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 Products API

The Products API from Rillet — 2 operation(s) for products.

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

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

This API exposes 5 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.

5 operations 2 paths 21 schemas 1 DELETE2 GET1 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 Products API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 5

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

Products 5
GET
/products
Lists all products
list-all-products 4 params → 200default
POST
/products
Creates a product
create-a-product body → 200default
GET
/products/{product_id}
Retrieves a product
retrieve-a-product 1 param → 200default
PUT
/products/{product_id}
Updates a product
update-a-product 1 param body → 200default
DELETE
/products/{product_id}
Deletes a product
delete-a-product 1 param → 204default

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are Product (9 properties), ProductRequest (8 properties), Error (4 properties), PerUnitBilling (3 properties). Each schema is shown below with its type and property counts.

TieredBilling
object
All tiers except for the highest have to define a value for upTo. There cannot be more than one tier with the same upTo value.
3 properties 3 required
AccountCode
string
The account code found in the Chart of Accounts
BillingScheme
Price
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
Pagination
object
1 property
FixedRecurringPrice
UsagePrice
MonetaryAmount
object
2 properties 2 required
Tier
object
At least one of flatPrice or perUnitPrice has to be defined. flatPrice is the price for the entire tier. perUnitPrice is price for units relevant to the tier.
3 properties 1 required
Error
object
4 properties 2 required
PageCursor
string
If defined, a cursor to retrieve the next page.
PageLimit
integer
ProductRequest
object
8 properties 6 required
FixedPrice
object
1 property 1 required
CurrencyCode
string
Currency code following ISO-4217
OneTimePrice
Product
object
9 properties 8 required
RevenuePattern
string
DAILY means that the revenue is divided equally per day in the revenue period. EVENPERIOD means that the revenue is divided equally for each calendar month in…
PerUnitBilling
object
3 properties 3 required
RecurringPrice
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rillet-products-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 Bills 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