Skip to content
RentMochi

Developer API

Build on the records Mochi keeps in order

The v1 API exposes the property, tenant, ledger, document, maintenance, and notification workflows listed below. It is available on Landlord and Portfolio plans. Ledger writes stay proposed until an explicitly scoped confirmation request approves them.

OpenAPI 3.1 JSONCreate an API key

Authenticate and stay within scope

Send a key as Authorization: Bearer rpb_…. The v1 routes share a limit of 100 requests per key per minute; a 429 response includes Retry-After. Every write also requires a unique Idempotency-Key, retained for 24 hours.

curl "$RENTMOCHI_URL/api/v1/properties" \
  -H "Authorization: Bearer $RENTMOCHI_API_KEY"
read:ledger

Read ledger entries.

read:properties

Read properties.

read:tenants

Read tenants.

read:notifications

Read unread notifications.

write:ledger

Create proposed ledger entries.

write:ledger.confirm

Explicitly confirm proposed ledger entries.

write:documents

Analyze documents into pending proposals.

write:maintenance

Create maintenance records.

write:properties

Create properties.

write:tenants

Create tenants.

Shipped endpoints

get/api/v1/properties

List properties

read:properties
post/api/v1/properties

Create a property

write:properties
get/api/v1/properties/{id}/ledger

List one property's ledger entries

read:ledger
get/api/v1/properties/{id}/tenants

List one property's tenants

read:tenants
get/api/v1/tenants

List tenants across all properties

read:tenants
post/api/v1/tenants

Create a tenant

write:tenants
get/api/v1/ledger

List ledger entries

read:ledger
post/api/v1/ledger

Create a proposed ledger entry

write:ledger
patch/api/v1/ledger/{id}

Confirm a proposed ledger entry

write:ledger.confirm
post/api/v1/documents

Analyze a document into a pending proposal

write:documents
post/api/v1/maintenance

Create a maintenance record

write:maintenance
get/api/v1/notifications

List unread notifications

read:notifications

Signed, durable webhooks

RentMochi persists a delivery before the first attempt and signs the exact JSON body with HMAC-SHA256 in X-RentMochi-Signature. Failed deliveries retry after 1m, 5m, 30m, 2h and become dead after 5 attempts.

tenant.added

Tenant added

ledger.created

Ledger entry created

ledger.confirmed

Ledger entry confirmed

document.filed

Document filed

maintenance.reported

Maintenance reported

maintenance.updated

Maintenance updated

payment.recorded

Payment recorded

lease.renewed

Lease renewed

property.added

Property added