Collect (Finance & Billing) (v1-2025-04-18)

The Finance, or Collect, API provides all the accounts receivable capabilities in Rhythm. This includes all aspects of Invoices, Credits, Payments, Credit Memos, and Debit Memos. Additionally, this API manages Batches and Fiscal Periods and can be used to download batches for import into your accounting package.

Like most of the other Rhythm apps, the Collect API includes endpoints for Query Definitions. These endpoints are commonly used to retrieve saved queries, which can then be executed using the Query endpoints of the System API.

Download OpenAPI description
Languages
Servers
Mock server

https://docs.api.rhythmsoftware.com/_mock/apis/collect/collect-v1/

https://collect.api.rhythmsoftware.com/

Accounting Projects

Accounting Projects

Operations

Bank Accounts

Bank Accounts

Operations

Batch Assignment Settings

Batch Assignment Settings

Operations

Batch Downloading

Batch Downloading

Operations

Batch Posting

Batch Posting

Operations

Batch Templates

Batch Templates

Operations

Batches

Batches

Operations

Billing Notices

Billing Notices

Operations

Billing Run Actions

Billing Run Actions

Operations

Billing Runs

Billing Runs

Operations

Billing Templates

Billing Templates

Operations

Business Units

Business Units

Operations

Check Request Processes

Check Request Processes

Operations

Check Request Templates

Check Request Templates

Operations

Check Requests

Check Requests

Operations

Cogs Entries

Cogs Entries

Operations

Credit Memos

Credit Memos

Operations

Credits

Credits

Operations

Currency Mapping Policies

Currency Mapping Policies

Operations

Debit Memos

Debit Memos

Operations

Departments

Departments

Operations

Donation Products

Donation Products

Operations

Exchange Rates

Exchange Rates

Operations

External Payments

External Payments

Operations

Fiscal Years

Fiscal Years

Operations

Gateway Entities

Gateway Entities

Operations

Gateway Entries

Gateway Entries

Operations

Gateway Fees

Gateway Fees

Operations

Gl Accounts

Gl Accounts

Operations

Installment Plans

Installment Plans

Operations

Installment Schedules

Installment Schedules

Operations

Invoice Payment Terms

Invoice Payment Terms

Operations

Invoice Templates

Invoice Templates

Operations

Invoice Types

Invoice Types

Operations

Invoices

Invoices

Operations

Finds all legacy invoices with an open balance and regenerates them

Request

Finds all legacy invoices with an open balance and regenerates them

Security
knox-authorizer
Path
tenantIdstringrequired

The id of the tenant being accessed

business_unit_idstringrequired

The business unit

curl -i -X POST \
  'https://docs.api.rhythmsoftware.com/_mock/apis/collect/collect-v1/invoices/{tenantId}/regenerateOpenInvoices/{business_unit_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

The generation completed successfully

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
batch_idstring(Batch)
errorsnumber(float)(Errors)
successnumber(float)(Success)
totalnumber(float)(Total)
Response
application/json
{ "batch_id": "string", "errors": 0.1, "success": 0.1, "total": 0.1 }

Generates a PDF and returns the public link for download

Request

Generates a PDF and returns the public link for download

Security
knox-authorizer
Path
tenantIdstringrequired

The id of the tenant being accessed

idstringrequired

The ID of the invoice to return

curl -i -X GET \
  'https://docs.api.rhythmsoftware.com/_mock/apis/collect/collect-v1/invoices/{tenantId}/renderEmail/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

The invoice was downloaded successfully

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
object
Response
application/json
{}

Searches for invoices using predefined parameters

Request

Searches for invoices using predefined parameters

Security
knox-authorizer
Path
tenantIdstringrequired

The id of the tenant being accessed.

Query
exclusiveStartKeystring

The start key for the search, for paging support

fieldsToReturnstring

The fields that you want to retrieve; if omitted, the entire object is returned

Bodyapplication/jsonrequired

The invoice that you would like to be saved.

amount_paidArray of numbers(float)(Amount Paid)= 2 items
balance_dueArray of numbers(float)(Balance Due)= 2 items
batch_idArray of strings(Batch)
bill_to_contact_idstring(Bill To Contact)
bill_to_organization_idstring(Bill To Organization)
bill_to_typestring(Bill To Type)
business_unit_idstring(Business Unit)required

The business unit

dateArray of strings(Date)= 2 items
date_dueArray of strings(date-time)(Date Due)= 2 items
idArray of strings(ID)
numberArray of numbers(float)(Number)= 2 items
purchase_order_numberArray of strings(Purchase Order Number)
totalArray of numbers(float)(Total)= 2 items
total_in_base_currencyArray of numbers(float)(Total In Base Currency)= 2 items
curl -i -X POST \
  'https://docs.api.rhythmsoftware.com/_mock/apis/collect/collect-v1/invoices/{tenantId}/search?exclusiveStartKey=string&fieldsToReturn=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount_paid": [
      0.1,
      0.1
    ],
    "balance_due": [
      0.1,
      0.1
    ],
    "batch_id": [
      "string"
    ],
    "bill_to_contact_id": "string",
    "bill_to_organization_id": "string",
    "bill_to_type": "string",
    "business_unit_id": "string",
    "date": [
      "string",
      "string"
    ],
    "date_due": [
      "2019-08-24T14:15:22Z",
      "2019-08-24T14:15:22Z"
    ],
    "id": [
      "string"
    ],
    "number": [
      0.1,
      0.1
    ],
    "purchase_order_number": [
      "string"
    ],
    "total": [
      0.1,
      0.1
    ],
    "total_in_base_currency": [
      0.1,
      0.1
    ]
  }'

Responses

The invoice search was saved successfully.

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
ItemsArray of objects(InvoiceSearchResults)
LastEvaluatedKeystring
Response
application/json
{ "Items": [ {} ], "LastEvaluatedKey": "string" }

Late Fee Rules

Late Fee Rules

Operations

Late Fees

Late Fees

Operations

Legacy Import Products

Legacy Import Products

Operations

Merchant Accounts

Merchant Accounts

Operations

Miscellaneous Products

Miscellaneous Products

Operations

Payment Receipt Templates

Payment Receipt Templates

Operations

Payments

Payments

Operations

Product Financial Configs

Product Financial Configs

Operations

Query Definitions

Query Definitions

Operations

Recurring Batches

Recurring Batches

Operations

Recurring Billing Runs

Recurring Billing Runs

Operations

Refund Receipt Templates

Refund Receipt Templates

Operations

Refunds

Refunds

Operations

Revenue Recognition Schedules

Revenue Recognition Schedules

Operations

Settings

Settings

Operations

Statement Templates

Statement Templates

Operations

Statements

Statements

Operations

Statistics

Statistics

Operations

Stored Payment Methods

Stored Payment Methods

Operations

Subledger Entries

Subledger Entries

Operations

Write Offs

Write Offs

Operations