Rillet

App · 27 actions

Run accounting in Rillet: sync customers and vendors, create invoices and bills, record payments, post journal entries, read contracts and pull the income statement and balance sheet.

Actions

ActionWhat it does
Create billEnter a vendor's bill to pay later.
Create customerAdd a customer to invoice, with a billing email, payment terms and billing address.
Create invoiceCreate an invoice for a customer, numbered by Rillet.
Create journal entryPost a manual journal entry: an amount debited to one account and credited to another, or a list of lines whose debits equal their credits.
Create productAdd a product or service to sell on invoices, with its price, how often it is billed and the income account it posts to.
Create vendorAdd a vendor to enter bills for, with the expense account and payment terms its bills use by default.
Delete billDelete a bill for good, such as one entered by mistake.
Delete customerDelete a customer for good.
Delete invoiceDelete an invoice for good, such as one made by mistake.
Delete invoice paymentUndo a payment recorded by mistake, so the invoice is owed again.
Delete journal entryDelete a manual journal entry for good, while its period is still open.
Delete productDelete a product for good.
Delete vendorDelete a vendor for good.
Find customersList customers, newest first, or find them by name.
Get balance sheetGet the balance sheet on a day: assets, liabilities and equity.
Get customerGet one customer with their billing emails and addresses.
Get income statementGet the profit and loss for a date range: revenue, costs, gross profit and net income.
Get invoiceGet one invoice with its lines, totals, amount still due and payment status.
List accountsList the chart of accounts with each account's code, name and type, optionally only one type.
List billsList bills, newest first, by vendor or payment status.
List contractsList customer contracts, newest first, by customer, status or end date, for example to find renewals coming up.
List invoicesList invoices, newest first, by customer, payment status or overdue.
List journal entriesList journal entries, newest first, posted between two dates.
List vendorsList vendors, newest first.
Mark invoice as sentRecord that an invoice was sent to the customer, for example by another system, or mark it as not sent again.
Record invoice paymentRecord money received for an invoice into a bank or cash account.
Update customerChange a customer's name, billing email, payment terms, billing address or reminder settings.

Create bill

Enter a vendor's bill to pay later. The expense account and due date default to the vendor's own.

Inputs

Vendorvendor_idtextRequired
The vendor. Pick one, or give its id from an earlier step.
Bill numberbill_numbertextRequired
The number on the vendor's bill.
AmountamountnumberRequired
The bill's total, such as 250.00.
Expense accountaccount_codetext
The expense account. Defaults to the vendor's.
Descriptiondescriptiontext
What the bill is for.
Bill datebill_datedate
The bill's date. Defaults to today.
Due datedue_datedate
When it is due. Defaults to the bill date plus the vendor's payment terms.
Currencycurrencytext
The bill's three-letter currency code, such as USD. Defaults to the subsidiary's currency.
Subsidiarysubsidiary_idtext
The subsidiary. Leave empty for the organization's default one.
More linesmore_lineslist
Lines after the first, each with an amount and, if you like, an account code and description.

Outputs

billobject
The bill
Example output
{
  "bill": {
    "bill_date": "2026-10-15",
    "due_date": "2026-11-14",
    "expense_number": "B123",
    "id": "0193a6f2-ce9a-7302-9fbb-a0de6c9d5bc8",
    "items": [
      {
        "account_code": "60000",
        "amount": {
          "amount": "250.00",
          "currency": "USD"
        },
        "description": "API Bill",
        "id": "0193a6f2-dfab-7413-8acc-b1ef7dae6cd9"
      }
    ],
    "status": "UNPAID",
    "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
    "updated_at": "2026-10-15T09:00:00Z",
    "vendor_id": "0193a6f2-bd8f-72f1-8eaa-9fcd5b8c4ab7"
  }
}

Create customer

Add a customer to invoice, with a billing email, payment terms and billing address.

Inputs

NamenametextRequired
The customer's name.
Name on invoicesname_on_invoicetext
The name printed on invoices, when it differs from the name.
Billing emailemailtext
The address invoices are emailed to.
Payment terms (days)payment_termsnumber
Days the customer has to pay each invoice, such as 30.From 0 to 365.
Street addressaddress_line1text
The first line of the address, such as 123 Main St.
Address line 2address_line2text
An apartment, suite or floor.
Citycitytext
The city.
Statestatetext
The state or province code, such as CA. Needed for a United States address.
Postal codezip_codetext
The ZIP or postal code.
Countrycountrytext
The two-letter country code, such as US or GB.
Email invoices automaticallysend_invoices_automaticallytrue/false
Have Rillet email each invoice to the customer on its date.
Send payment reminderssend_payment_reminderstrue/false
Have Rillet remind the customer about unpaid invoices.

Outputs

customerobject
The customer
Example output
{
  "customer": {
    "billing_addresses": [
      {
        "city": "Nashville",
        "country": "US",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f42",
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "state": "TN",
        "zip_code": "37201"
      }
    ],
    "emails": [
      {
        "email": "bobjohnson@somedomain.com",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f41",
        "type": "MAIN_SENDER"
      }
    ],
    "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
    "name": "Bob",
    "name_on_invoice": "Bob Johnson",
    "payment_terms": 30,
    "send_invoices_automatically": false,
    "send_payment_reminders": false,
    "updated_at": "2026-10-15T09:00:00Z"
  }
}

Create invoice

Create an invoice for a customer, numbered by Rillet. Each line is a product, priced from the product unless a price is given. If an approval workflow applies, the invoice waits for approval.

Inputs

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.
Productproduct_idtextRequired
The product. Pick one, or give its id from an earlier step.
Quantityquantitynumber
How many. Defaults to 1.
Unit priceunit_pricenumber
The price per unit. Defaults to the product's price.
Currencycurrencytext
The invoice's three-letter currency code, such as USD. Defaults to the product's currency.
Line descriptiondescriptiontext
The line's text. Defaults to the product's description.
Invoice dateinvoice_datedate
The invoice's date. Defaults to today.
Due datedue_datedate
When it is due. Defaults to the invoice date.
Service fromservice_startdate
The first day of the service billed, for spreading the revenue. Defaults to the invoice date.
Service untilservice_enddate
The last day of the service billed.
Memomemotext
A note printed on the invoice.
PO numberpurchase_order_numbertext
The customer's purchase order number.
Subsidiarysubsidiary_idtext
The subsidiary. Leave empty for the organization's default one.
More linesmore_lineslist
Lines after the first, each with a product id and, if you like, a quantity, unit price and description.

Outputs

approval_request_idtext
The approval request's id, when it waits for approval
approval_statustext
created, or pending approval when an approval workflow holds it
invoiceobject
The invoice; empty while it waits for approval
invoice_idtext
The invoice's id
Example output
{
  "approval_request_id": "",
  "approval_status": "created",
  "invoice": {
    "amount_due": {
      "amount": "20.00",
      "currency": "USD"
    },
    "contract_id": null,
    "customer_id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
    "due_date": "2026-11-14",
    "id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
    "invoice_date": "2026-10-15",
    "invoice_number": "INV01",
    "items": [
      {
        "description": "Subscription to english classes",
        "gross_rate": {
          "amount": "10.00",
          "currency": "USD"
        },
        "id": "0193a6f2-8a5c-7fce-9b7d-6c9a2e5f1d84",
        "product_id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51",
        "quantity": "2.0000",
        "taxed_amount": {
          "amount": "0.00",
          "currency": "USD"
        },
        "total_amount": {
          "amount": "20.00",
          "currency": "USD"
        }
      }
    ],
    "memo": null,
    "overdue": false,
    "purchase_order_number": "PO-12345",
    "sent_at": null,
    "status": "UNPAID",
    "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
    "subtotal": {
      "amount": "20.00",
      "currency": "USD"
    },
    "taxed_amount": {
      "amount": "0.00",
      "currency": "USD"
    },
    "total": {
      "amount": "20.00",
      "currency": "USD"
    },
    "updated_at": "2026-10-15T09:00:00Z"
  },
  "invoice_id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62"
}

Create journal entry

Post a manual journal entry: an amount debited to one account and credited to another, or a list of lines whose debits equal their credits.

Inputs

NamenametextRequired
What the entry is for.
Amountamountnumber
The amount to move. Leave empty when giving lines.
Debit accountdebit_account_codetext
The account debited. Leave empty when giving lines.
Credit accountcredit_account_codetext
The account credited. Leave empty when giving lines.
Line descriptiondescriptiontext
Text for each line.
Dateentry_datedate
The posting date. Defaults to today.
Currencycurrencytext
The entry's three-letter currency code, such as USD. Defaults to the subsidiary's currency.
Subsidiarysubsidiary_idtext
The subsidiary. Leave empty for the organization's default one.
Reverse onreversal_datedate
A date to reverse the entry automatically, such as the first of next month for an accrual.
Lineslineslist
Instead of one amount: each line's account code, side (DEBIT or CREDIT) and amount. Debits must equal credits.

Outputs

journal_entryobject
The journal entry
Example output
{
  "journal_entry": {
    "book_id": "0193a6f2-f1cd-7635-8cee-d3019fc08efb",
    "currency": "USD",
    "date": "2026-10-31",
    "id": "0193a6f2-e0bc-7524-9bdd-c2f08ebf7dea",
    "items": [
      {
        "account_code": "60000",
        "account_id": "0193a6f3-13ef-7857-8e00-f523b1e2a01d",
        "amount": {
          "amount": "500.00",
          "currency": "USD"
        },
        "description": "October hosting",
        "id": "0193a6f3-02de-7746-9dff-e412a0d19f0c",
        "side": "DEBIT"
      },
      {
        "account_code": "20000",
        "account_id": "0193a6f3-3501-7a79-8a22-1745d304c23f",
        "amount": {
          "amount": "500.00",
          "currency": "USD"
        },
        "description": "October hosting",
        "id": "0193a6f3-24f0-7968-9f11-0634c2f3b12e",
        "side": "CREDIT"
      }
    ],
    "name": "Accrue October hosting",
    "reversal_date": "2026-11-01",
    "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
    "updated_at": "2026-10-31T09:00:00Z"
  }
}

Create product

Add a product or service to sell on invoices, with its price, how often it is billed and the income account it posts to.

Inputs

NamenametextRequired
The product's name.
PricepricenumberRequired
The price per unit, such as 99.00.
Income accountrevenue_account_codetextRequired
The income account the product's revenue posts to.
Billedbillingtext
Once, or again every month, quarter, half year or year.One of: ONE_TIME (One time (default)), MONTHLY (Every month), QUARTERLY (Every 3 months), HALF_YEARLY (Every 6 months), YEARLY (Every year).
Currencycurrencytext
The price's three-letter currency code, such as USD. Defaults to your organization's currency.
Descriptiondescriptiontext
What it is. Defaults to the name.
Revenue recognitionrevenue_patterntext
How its revenue is spread over the service period.One of: DAILY (Spread evenly by day (default)), EVEN_PERIOD (Spread evenly by month).
Count towards ARR and MRRinclude_in_arr_mrrtrue/false
Whether its revenue counts as recurring. Defaults to yes for a recurring price and no for a one-time price.

Outputs

productobject
The product
Example output
{
  "product": {
    "account_code": "40000",
    "description": "Subscription to english classes",
    "id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51",
    "include_in_arr_mrr": true,
    "name": "English subscription",
    "price": {
      "amount": {
        "amount": "10.00",
        "currency": "USD"
      },
      "interval_months": 1,
      "type": "FIXED_RECURRING"
    },
    "revenue_pattern": "DAILY",
    "status": "ACTIVE",
    "type": "PRODUCT"
  }
}

Create vendor

Add a vendor to enter bills for, with the expense account and payment terms its bills use by default.

Inputs

NamenametextRequired
The vendor's name.
Emailemailtext
The vendor's email address.
Default expense accountdefault_account_codetext
The expense account the vendor's bills post to.
Payment terms (days)payment_termsnumber
Days until the vendor's bills are due, such as 30.From 0 to 180.
Tax IDtax_idtext
The vendor's tax id, such as an EIN.
Gets a 1099eligible_for_1099true/false
Whether the vendor is due a 1099 form.
Street addressaddress_line1text
The first line of the address, such as 123 Main St.
Address line 2address_line2text
An apartment, suite or floor.
Citycitytext
The city.
Statestatetext
The state or province code, such as CA. Needed for a United States address.
Postal codezip_codetext
The ZIP or postal code.
Countrycountrytext
The two-letter country code, such as US or GB.

Outputs

vendorobject
The vendor
Example output
{
  "vendor": {
    "account_code": "60000",
    "address": {
      "city": "Nashville",
      "country": "US",
      "line1": "123 Main St",
      "line2": null,
      "state": "TN",
      "zip_code": "37201"
    },
    "email": "billing@myvendor.example",
    "id": "0193a6f2-bd8f-72f1-8eaa-9fcd5b8c4ab7",
    "name": "MyVendor",
    "payment_terms": 30,
    "tax_id": "123",
    "ten_ninety_nine_eligible": false,
    "updated_at": "2026-10-15T09:00:00Z"
  }
}

Delete bill

Delete a bill for good, such as one entered by mistake.

Inputs

Bill IDbill_idtextRequired
The bill's id, from 'List bills' or an earlier step.

Outputs

bill_idtext
The bill deleted
deletedtrue/false
Always true once deleted
Example output
{
  "bill_id": "0193a6f2-ce9a-7302-9fbb-a0de6c9d5bc8",
  "deleted": true
}

Delete customer

Delete a customer for good. Do this only when no contract or invoice still belongs to them.

Inputs

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.

Outputs

customer_idtext
The customer deleted
deletedtrue/false
Always true once deleted
Example output
{
  "customer_id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
  "deleted": true
}

Delete invoice

Delete an invoice for good, such as one made by mistake. Delete its payments first.

Inputs

Invoice IDinvoice_idtextRequired
The invoice's id, from 'List invoices' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
invoice_idtext
The invoice deleted
Example output
{
  "deleted": true,
  "invoice_id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62"
}

Delete invoice payment

Undo a payment recorded by mistake, so the invoice is owed again. Only payments that have not cleared can be deleted.

Inputs

Invoice IDinvoice_idtextRequired
The invoice's id, from 'List invoices' or an earlier step.
Payment IDpayment_idtextRequired
The payment's id, from 'Record invoice payment'.

Outputs

deletedtrue/false
Always true once deleted
invoice_idtext
The invoice the payment was on
payment_idtext
The payment deleted
Example output
{
  "deleted": true,
  "invoice_id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
  "payment_id": "0193a6f2-9b6d-70df-8c8e-7dab3f6a2e95"
}

Delete journal entry

Delete a manual journal entry for good, while its period is still open.

Inputs

Journal entry IDjournal_entry_idtextRequired
The entry's id, from 'List journal entries' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
journal_entry_idtext
The journal entry deleted
Example output
{
  "deleted": true,
  "journal_entry_id": "0193a6f2-e0bc-7524-9bdd-c2f08ebf7dea"
}

Delete product

Delete a product for good. Do this only when no contract or invoice still needs it.

Inputs

Productproduct_idtextRequired
The product. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
product_idtext
The product deleted
Example output
{
  "deleted": true,
  "product_id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51"
}

Delete vendor

Delete a vendor for good. Do this only when no bill, credit or payment still belongs to them.

Inputs

Vendorvendor_idtextRequired
The vendor. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
vendor_idtext
The vendor deleted
Example output
{
  "deleted": true,
  "vendor_id": "0193a6f2-bd8f-72f1-8eaa-9fcd5b8c4ab7"
}

Find customers

List customers, newest first, or find them by name. Gets one page; to see more, run it again with the next page it gives.

Inputs

Namesearchtext
Only customers whose name matches this.
Changed afterupdated_afterdate and time
Only those created or changed after this time.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

countnumber
How many are on this page
customerslist
The customers
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
Example output
{
  "count": 1,
  "customers": [
    {
      "billing_addresses": [
        {
          "city": "Nashville",
          "country": "US",
          "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f42",
          "line1": "123 Main St",
          "line2": "Apt 4B",
          "state": "TN",
          "zip_code": "37201"
        }
      ],
      "emails": [
        {
          "email": "bobjohnson@somedomain.com",
          "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f41",
          "type": "MAIN_SENDER"
        }
      ],
      "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
      "name": "Bob",
      "name_on_invoice": "Bob Johnson",
      "payment_terms": 30,
      "send_invoices_automatically": false,
      "send_payment_reminders": false,
      "updated_at": "2026-10-15T09:00:00Z"
    }
  ],
  "next_cursor": ""
}

Get balance sheet

Get the balance sheet on a day: assets, liabilities and equity. Defaults to today.

Inputs

Onas_of_datedate
The day the balances are for. Defaults to today.
Subsidiarysubsidiary_idtext
Only this subsidiary. Leave empty for all of them.

Outputs

as_of_datetext
The day, as YYYY-MM-DD
breakdownslist
The report's columns
currencytext
The report's currency
sectionslist
The report's sections, with their groups and accounts
totalslist
Each section's total, then each summary line
Example output
{
  "as_of_date": "2026-10-31",
  "breakdowns": [
    {
      "id": null,
      "name": "Total",
      "type": "PERIOD"
    }
  ],
  "currency": "USD",
  "sections": [
    {
      "groups": [
        {
          "accounts": [
            {
              "balances": [
                {
                  "amount": {
                    "amount": "250000.00",
                    "currency": "USD"
                  },
                  "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
                }
              ],
              "code": "10100",
              "id": "0193a6f3-6834-7dac-9d55-4a78a637f562",
              "name": "Cash"
            }
          ],
          "name": "Current Assets",
          "totals": [
            {
              "amount": {
                "amount": "250000.00",
                "currency": "USD"
              },
              "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
            }
          ]
        }
      ],
      "name": "Assets",
      "totals": [
        {
          "amount": {
            "amount": "250000.00",
            "currency": "USD"
          },
          "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
        }
      ]
    }
  ],
  "totals": [
    {
      "amount": "250000.00",
      "currency": "USD",
      "name": "Assets"
    }
  ]
}

Get customer

Get one customer with their billing emails and addresses.

Inputs

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.

Outputs

customerobject
The customer
Example output
{
  "customer": {
    "billing_addresses": [
      {
        "city": "Nashville",
        "country": "US",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f42",
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "state": "TN",
        "zip_code": "37201"
      }
    ],
    "emails": [
      {
        "email": "bobjohnson@somedomain.com",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f41",
        "type": "MAIN_SENDER"
      }
    ],
    "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
    "name": "Bob",
    "name_on_invoice": "Bob Johnson",
    "payment_terms": 30,
    "send_invoices_automatically": false,
    "send_payment_reminders": false,
    "updated_at": "2026-10-15T09:00:00Z"
  }
}

Get income statement

Get the profit and loss for a date range: revenue, costs, gross profit and net income. Defaults to this month so far.

Inputs

Fromfrom_datedate
The first day. Defaults to the first of this month.
Toto_datedate
The last day. Defaults to today.
Subsidiarysubsidiary_idtext
Only this subsidiary. Leave empty for all of them.

Outputs

breakdownslist
The report's columns
currencytext
The report's currency
periodobject
The dates the report covers
sectionslist
The report's sections, with their groups and accounts
summarieslist
Summary lines such as Gross Profit and Net Income
totalslist
Each section's total, then each summary line
Example output
{
  "breakdowns": [
    {
      "id": null,
      "name": "Total",
      "type": "PERIOD"
    }
  ],
  "currency": "USD",
  "period": {
    "from_date": "2026-10-01",
    "to_date": "2026-10-31"
  },
  "sections": [
    {
      "groups": [
        {
          "accounts": [
            {
              "balances": [
                {
                  "amount": {
                    "amount": "12500.00",
                    "currency": "USD"
                  },
                  "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
                }
              ],
              "code": "40000",
              "id": "0193a6f3-6834-7dac-9d55-4a78a637f562",
              "name": "Sales"
            }
          ],
          "name": "Subscription Revenue",
          "totals": [
            {
              "amount": {
                "amount": "12500.00",
                "currency": "USD"
              },
              "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
            }
          ]
        }
      ],
      "name": "Revenue",
      "totals": [
        {
          "amount": {
            "amount": "12500.00",
            "currency": "USD"
          },
          "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
        }
      ]
    }
  ],
  "summaries": [
    {
      "amounts": [
        {
          "amount": {
            "amount": "4200.00",
            "currency": "USD"
          },
          "breakdown_id": "0193a6f3-5723-7c9b-8c44-3967f526e451"
        }
      ],
      "name": "Net Income"
    }
  ],
  "totals": [
    {
      "amount": "12500.00",
      "currency": "USD",
      "name": "Revenue"
    },
    {
      "amount": "4200.00",
      "currency": "USD",
      "name": "Net Income"
    }
  ]
}

Get invoice

Get one invoice with its lines, totals, amount still due and payment status.

Inputs

Invoice IDinvoice_idtextRequired
The invoice's id, from 'List invoices' or an earlier step.

Outputs

invoiceobject
The invoice
Example output
{
  "invoice": {
    "amount_due": {
      "amount": "20.00",
      "currency": "USD"
    },
    "contract_id": null,
    "customer_id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
    "due_date": "2026-11-14",
    "id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
    "invoice_date": "2026-10-15",
    "invoice_number": "INV01",
    "items": [
      {
        "description": "Subscription to english classes",
        "gross_rate": {
          "amount": "10.00",
          "currency": "USD"
        },
        "id": "0193a6f2-8a5c-7fce-9b7d-6c9a2e5f1d84",
        "product_id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51",
        "quantity": "2.0000",
        "taxed_amount": {
          "amount": "0.00",
          "currency": "USD"
        },
        "total_amount": {
          "amount": "20.00",
          "currency": "USD"
        }
      }
    ],
    "memo": null,
    "overdue": false,
    "purchase_order_number": "PO-12345",
    "sent_at": null,
    "status": "UNPAID",
    "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
    "subtotal": {
      "amount": "20.00",
      "currency": "USD"
    },
    "taxed_amount": {
      "amount": "0.00",
      "currency": "USD"
    },
    "total": {
      "amount": "20.00",
      "currency": "USD"
    },
    "updated_at": "2026-10-15T09:00:00Z"
  }
}

List accounts

List the chart of accounts with each account's code, name and type, optionally only one type.

Inputs

Typeaccount_typetext
Only accounts of this type.One of: INCOME, EXPENSE, ASSET, BANK (Bank and cash), LIABILITY, EQUITY.
Include inactive accountsinclude_inactivetrue/false
Also list accounts that are no longer in use.

Outputs

accountslist
The accounts, by code
countnumber
How many
Example output
{
  "accounts": [
    {
      "code": "10100",
      "id": "0193a6f3-4612-7b8a-9b33-2856e415d340",
      "name": "Mercury Savings",
      "parent_grouping": "Cash",
      "status": "ACTIVE",
      "subtype": "Bank",
      "type": "ASSET",
      "updated_at": "2026-10-01T09:00:00Z"
    }
  ],
  "count": 1
}

List bills

List bills, newest first, by vendor or payment status. Gets one page; to see more, run it again with the next page it gives.

Inputs

Vendorvendor_idtext
Only this vendor's.
Payment statusstatustext
Only bills with this payment status.One of: UNPAID, PARTIALLY_PAID (Partly paid), PAID, PARTIALLY_CREDITED (Partly credited), CREDITED, APPLIED.
Subsidiarysubsidiary_idtext
Only this subsidiary's. Leave empty for all of them.
Changed afterupdated_afterdate and time
Only those created or changed after this time.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

billslist
The bills
countnumber
How many are on this page
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
Example output
{
  "bills": [
    {
      "bill_date": "2026-10-15",
      "due_date": "2026-11-14",
      "expense_number": "B123",
      "id": "0193a6f2-ce9a-7302-9fbb-a0de6c9d5bc8",
      "items": [
        {
          "account_code": "60000",
          "amount": {
            "amount": "250.00",
            "currency": "USD"
          },
          "description": "API Bill",
          "id": "0193a6f2-dfab-7413-8acc-b1ef7dae6cd9"
        }
      ],
      "status": "UNPAID",
      "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
      "updated_at": "2026-10-15T09:00:00Z",
      "vendor_id": "0193a6f2-bd8f-72f1-8eaa-9fcd5b8c4ab7"
    }
  ],
  "count": 1,
  "next_cursor": ""
}

List contracts

List customer contracts, newest first, by customer, status or end date, for example to find renewals coming up. Gets one page; to see more, run it again with the next page it gives.

Inputs

Customercustomer_idtext
Only this customer's.
Statusstatustext
Only contracts with this status.One of: ACTIVE, IN_EFFECT (In effect), ENDED, CANCELLED, AMENDED.
Ending on or afterending_fromdate
Only contracts that end on or after this date.
Ending on or beforeending_untildate
Only contracts that end on or before this date.
Subsidiarysubsidiary_idtext
Only this subsidiary's. Leave empty for all of them.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

contractslist
The contracts
countnumber
How many are on this page
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
Example output
{
  "contracts": [
    {
      "close_date": "2025-12-15",
      "customer_id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
      "end_date": "2026-12-31",
      "id": "0193a6f2-ac7e-71e0-9d9f-8ebc4a7b3fa6",
      "items": [
        {
          "end_date": "2026-12-31",
          "product_id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51",
          "quantity": "1",
          "start_date": "2026-01-01",
          "status": "ACTIVE",
          "total_value": {
            "amount": "120.00",
            "currency": "USD"
          }
        }
      ],
      "name": "New API Contract",
      "purchase_order_number": "PO-12345",
      "start_date": "2026-01-01",
      "status": "ACTIVE",
      "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
      "total_value": {
        "amount": "120.00",
        "currency": "USD"
      }
    }
  ],
  "count": 1,
  "next_cursor": ""
}

List invoices

List invoices, newest first, by customer, payment status or overdue. Gets one page; to see more, run it again with the next page it gives.

Inputs

Customercustomer_idtext
Only this customer's.
Payment statusstatustext
Only invoices with this payment status.One of: UNPAID, PARTIALLY_PAID (Partly paid), PAID, UNBILLED, PARTIALLY_CREDITED (Partly credited), CREDITED.
Only overdueoverdue_onlytrue/false
Only invoices past their due date.
Subsidiarysubsidiary_idtext
Only this subsidiary's. Leave empty for all of them.
Changed afterupdated_afterdate and time
Only those created or changed after this time.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

countnumber
How many are on this page
invoiceslist
The invoices
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
Example output
{
  "count": 1,
  "invoices": [
    {
      "amount_due": {
        "amount": "20.00",
        "currency": "USD"
      },
      "contract_id": null,
      "customer_id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
      "due_date": "2026-11-14",
      "id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
      "invoice_date": "2026-10-15",
      "invoice_number": "INV01",
      "items": [
        {
          "description": "Subscription to english classes",
          "gross_rate": {
            "amount": "10.00",
            "currency": "USD"
          },
          "id": "0193a6f2-8a5c-7fce-9b7d-6c9a2e5f1d84",
          "product_id": "0193a6f2-5d2f-7c9b-8e4a-3f6d9b2c8a51",
          "quantity": "2.0000",
          "taxed_amount": {
            "amount": "0.00",
            "currency": "USD"
          },
          "total_amount": {
            "amount": "20.00",
            "currency": "USD"
          }
        }
      ],
      "memo": null,
      "overdue": false,
      "purchase_order_number": "PO-12345",
      "sent_at": null,
      "status": "UNPAID",
      "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
      "subtotal": {
        "amount": "20.00",
        "currency": "USD"
      },
      "taxed_amount": {
        "amount": "0.00",
        "currency": "USD"
      },
      "total": {
        "amount": "20.00",
        "currency": "USD"
      },
      "updated_at": "2026-10-15T09:00:00Z"
    }
  ],
  "next_cursor": ""
}

List journal entries

List journal entries, newest first, posted between two dates. Gets one page; to see more, run it again with the next page it gives.

Inputs

Posted on or afterfrom_datedate
Only entries posted on or after this date.
Posted on or beforeto_datedate
Only entries posted on or before this date.
Subsidiarysubsidiary_idtext
Only this subsidiary's. Leave empty for all of them.
Changed afterupdated_afterdate and time
Only those created or changed after this time.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

countnumber
How many are on this page
journal_entrieslist
The journal entries
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
Example output
{
  "count": 1,
  "journal_entries": [
    {
      "book_id": "0193a6f2-f1cd-7635-8cee-d3019fc08efb",
      "currency": "USD",
      "date": "2026-10-31",
      "id": "0193a6f2-e0bc-7524-9bdd-c2f08ebf7dea",
      "items": [
        {
          "account_code": "60000",
          "account_id": "0193a6f3-13ef-7857-8e00-f523b1e2a01d",
          "amount": {
            "amount": "500.00",
            "currency": "USD"
          },
          "description": "October hosting",
          "id": "0193a6f3-02de-7746-9dff-e412a0d19f0c",
          "side": "DEBIT"
        },
        {
          "account_code": "20000",
          "account_id": "0193a6f3-3501-7a79-8a22-1745d304c23f",
          "amount": {
            "amount": "500.00",
            "currency": "USD"
          },
          "description": "October hosting",
          "id": "0193a6f3-24f0-7968-9f11-0634c2f3b12e",
          "side": "CREDIT"
        }
      ],
      "name": "Accrue October hosting",
      "reversal_date": "2026-11-01",
      "subsidiary_id": "0193a6f2-7f4b-7ebd-8a6c-5b8f1d4e0c73",
      "updated_at": "2026-10-31T09:00:00Z"
    }
  ],
  "next_cursor": ""
}

List vendors

List vendors, newest first. Gets one page; to see more, run it again with the next page it gives.

Inputs

Changed afterupdated_afterdate and time
Only those created or changed after this time.
Page sizelimitnumber
How many to return, 1 to 100. Rillet's default is 25.From 1 to 100.
Next pagecursortext
The 'next_cursor' from an earlier page of the same list, to get the page after it. It works for two hours.

Outputs

countnumber
How many are on this page
next_cursortext
Pass as 'Next page' for the next page; empty on the last one
vendorslist
The vendors
Example output
{
  "count": 1,
  "next_cursor": "",
  "vendors": [
    {
      "account_code": "60000",
      "address": {
        "city": "Nashville",
        "country": "US",
        "line1": "123 Main St",
        "line2": null,
        "state": "TN",
        "zip_code": "37201"
      },
      "email": "billing@myvendor.example",
      "id": "0193a6f2-bd8f-72f1-8eaa-9fcd5b8c4ab7",
      "name": "MyVendor",
      "payment_terms": 30,
      "tax_id": "123",
      "ten_ninety_nine_eligible": false,
      "updated_at": "2026-10-15T09:00:00Z"
    }
  ]
}

Mark invoice as sent

Record that an invoice was sent to the customer, for example by another system, or mark it as not sent again.

Inputs

Invoice IDinvoice_idtextRequired
The invoice's id, from 'List invoices' or an earlier step.
Sentsenttrue/false
On to mark it as sent, off to mark it as not sent.Default: true.

Outputs

invoice_idtext
The invoice's id
senttrue/false
Whether it is now marked as sent
Example output
{
  "invoice_id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
  "sent": true
}

Record invoice payment

Record money received for an invoice into a bank or cash account. Defaults to the full amount still due, today.

Inputs

Invoice IDinvoice_idtextRequired
The invoice's id, from 'List invoices' or an earlier step.
Paid intoaccount_codetextRequired
The bank or cash account the money went into.
Amountamountnumber
How much was paid, in the invoice's currency. Defaults to all that is still due.
Payment datepayment_datedate
When it was paid. Defaults to today.

Outputs

paymentobject
The payment
Example output
{
  "payment": {
    "account_code": "10100",
    "amount": {
      "amount": "20.00",
      "currency": "USD"
    },
    "date": "2026-10-20",
    "id": "0193a6f2-9b6d-70df-8c8e-7dab3f6a2e95",
    "invoice_id": "0193a6f2-6e3a-7dac-9f5b-4a7e0c3d9b62",
    "status": "UNCLEARED",
    "updated_at": "2026-10-20T09:00:00Z"
  }
}

Update customer

Change a customer's name, billing email, payment terms, billing address or reminder settings. Only the fields given change.

Inputs

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Name on invoicesname_on_invoicetext
The name printed on invoices, when it differs from the name.
Billing emailemailtext
The address invoices are emailed to.
Payment terms (days)payment_termsnumber
Days the customer has to pay each invoice, such as 30.From 0 to 365.
Street addressaddress_line1text
The first line of the address, such as 123 Main St.
Address line 2address_line2text
An apartment, suite or floor.
Citycitytext
The city.
Statestatetext
The state or province code, such as CA. Needed for a United States address.
Postal codezip_codetext
The ZIP or postal code.
Countrycountrytext
The two-letter country code, such as US or GB.
Email invoices automaticallysend_invoices_automaticallytrue/false
Have Rillet email each invoice to the customer on its date.
Send payment reminderssend_payment_reminderstrue/false
Have Rillet remind the customer about unpaid invoices.

Outputs

customerobject
The customer
Example output
{
  "customer": {
    "billing_addresses": [
      {
        "city": "Nashville",
        "country": "US",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f42",
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "state": "TN",
        "zip_code": "37201"
      }
    ],
    "emails": [
      {
        "email": "bobjohnson@somedomain.com",
        "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f41",
        "type": "MAIN_SENDER"
      }
    ],
    "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
    "name": "Bob",
    "name_on_invoice": "Bob Johnson",
    "payment_terms": 30,
    "send_invoices_automatically": false,
    "send_payment_reminders": false,
    "updated_at": "2026-10-15T09:00:00Z"
  }
}

On this page