Properties Units Tenants Leases Payments Ledger Entries Payouts Owners Leads Users Expenses Evictions Fee Schedules Recurring Billing

Properties

A property represents a physical real estate asset — a building, complex, or single-family home.

Key Fields

Field	Type	Description
id	String	Unique identifier
name	String	Display name
address	Address	Full street address
type	PropertyType	RESIDENTIAL \| COMMERCIAL \| MIXED
ownerId	String	Owner user ID
units	Unit[]	Associated units
status	Status	ACTIVE \| INACTIVE \| ARCHIVED

Example

json

{
  "id": "prp_abc123",
  "name": "Sunset Apartments",
  "address": {
    "street": "123 Sunset Blvd",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90028"
  },
  "type": "RESIDENTIAL",
  "ownerId": "usr_own001",
  "status": "ACTIVE",
  "unitCount": 24
}

Related Endpoints

GET/api/properties

POST/api/properties

GET/api/properties/:id

PUT/api/properties/:id

DELETE/api/properties/:id

Units

A unit is a rentable space within a property — an apartment, suite, or room.

Key Fields

Field	Type	Description
id	String	Unique identifier
propertyId	String	Parent property
unitNumber	String	Unit number or label
bedrooms	Int	Number of bedrooms
bathrooms	Float	Number of bathrooms
sqft	Int?	Square footage
rentAmount	Decimal	Monthly rent in cents
status	UnitStatus	VACANT \| OCCUPIED \| MAINTENANCE

Example

json

{
  "id": "unt_456",
  "propertyId": "prp_abc123",
  "unitNumber": "4B",
  "bedrooms": 2,
  "bathrooms": 1.5,
  "sqft": 950,
  "rentAmount": 225000,
  "status": "OCCUPIED"
}

Related Endpoints

GET/api/properties/:id/units

POST/api/properties/:id/units

GET/api/units/:id

PUT/api/units/:id

Tenants

A tenant is a person who rents a unit. They have a user account and one or more lease associations.

Key Fields

Field	Type	Description
id	String	Unique identifier
userId	String	Associated user account
firstName	String	First name
lastName	String	Last name
email	String	Contact email
phone	String?	Phone number
status	TenantStatus	ACTIVE \| PAST \| APPLICANT

Example

json

{
  "id": "tnt_012",
  "userId": "usr_tnt012",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@example.com",
  "phone": "+1-555-0123",
  "status": "ACTIVE"
}

Related Endpoints

GET/api/tenants

POST/api/tenants

GET/api/tenants/:id

PUT/api/tenants/:id

Leases

A lease ties a tenant to a unit for a specific period with defined financial terms.

Key Fields

Field	Type	Description
id	String	Unique identifier
unitId	String	Leased unit
tenantId	String	Primary tenant
startDate	DateTime	Lease start date
endDate	DateTime	Lease end date
rentAmount	Decimal	Monthly rent in cents
securityDeposit	Decimal	Security deposit amount
status	LeaseStatus	ACTIVE \| EXPIRED \| TERMINATED

Example

json

{
  "id": "lea_xyz789",
  "unitId": "unt_456",
  "tenantId": "tnt_012",
  "startDate": "2025-01-01T00:00:00.000Z",
  "endDate": "2026-01-01T00:00:00.000Z",
  "rentAmount": 225000,
  "securityDeposit": 225000,
  "status": "ACTIVE"
}

Related Endpoints

GET/api/leases

POST/api/leases

GET/api/leases/:id

PUT/api/leases/:id

POST/api/leases/:id/terminate

Payments

A payment record tracks money movement — tenant rent payments processed through Kadima.

Key Fields

Field	Type	Description
id	String	Unique identifier
leaseId	String	Associated lease
tenantId	String	Paying tenant
amount	Decimal	Payment amount in cents
method	PaymentMethod	ACH \| CARD \| CHECK
status	PaymentStatus	PENDING \| COMPLETED \| FAILED \| REFUNDED
processedAt	DateTime?	When payment was processed
externalId	String?	Kadima transaction ID

Example

json

{
  "id": "pay_def456",
  "leaseId": "lea_xyz789",
  "tenantId": "tnt_012",
  "amount": 225000,
  "method": "ACH",
  "status": "COMPLETED",
  "processedAt": "2025-01-05T10:30:00.000Z",
  "externalId": "txn_kadima_abc"
}

Related Endpoints

GET/api/payments

POST/api/payments

GET/api/payments/:id

POST/api/payments/:id/refund

Ledger Entries

Immutable financial records that track every monetary event. See the Ledger System guide for details.

Key Fields

Field	Type	Description
id	String	Unique identifier
leaseId	String	Associated lease
type	EntryType	CHARGE \| PAYMENT \| REVERSAL \| ADJUSTMENT
amount	Decimal	Signed amount in cents
runningBalance	Decimal	Balance after this entry
description	String	Human-readable description

Example

json

{
  "id": "led_abc123",
  "leaseId": "lea_xyz789",
  "type": "CHARGE",
  "amount": 225000,
  "runningBalance": 225000,
  "description": "Rent charge - February 2025"
}

Related Endpoints

GET/api/ledger

GET/api/ledger/:leaseId

GET/api/ledger/:leaseId/balance

Payouts

Payouts represent disbursements from DoorStax to property owners after collecting rent.

Key Fields

Field	Type	Description
id	String	Unique identifier
ownerId	String	Recipient owner
amount	Decimal	Payout amount in cents
status	PayoutStatus	PENDING \| PROCESSING \| COMPLETED \| FAILED
scheduledDate	DateTime	Scheduled payout date
completedAt	DateTime?	When payout was sent

Example

json

{
  "id": "po_ghi789",
  "ownerId": "usr_own001",
  "amount": 2100000,
  "status": "COMPLETED",
  "scheduledDate": "2025-01-15T00:00:00.000Z",
  "completedAt": "2025-01-15T06:00:00.000Z"
}

Related Endpoints

GET/api/payouts

GET/api/payouts/:id

POST/api/payouts/:id/retry

Owners

Property owners who receive payouts and manage their portfolio through DoorStax.

Key Fields

Field	Type	Description
id	String	Unique identifier
userId	String	Associated user account
companyName	String?	Business entity name
properties	Property[]	Owned properties
payoutMethod	PayoutMethod	ACH \| WIRE \| CHECK

Example

json

{
  "id": "own_001",
  "userId": "usr_own001",
  "companyName": "Sunset Properties LLC",
  "propertyCount": 3,
  "payoutMethod": "ACH"
}

Related Endpoints

GET/api/owners

GET/api/owners/:id

PUT/api/owners/:id

Leads

Prospective tenants who have expressed interest in a unit but have not yet signed a lease.

Key Fields

Field	Type	Description
id	String	Unique identifier
unitId	String?	Interested unit
firstName	String	First name
lastName	String	Last name
email	String	Contact email
status	LeadStatus	NEW \| CONTACTED \| SCREENING \| APPROVED \| REJECTED
source	String?	Lead source (website, referral, etc.)

Example

json

{
  "id": "lead_jkl012",
  "unitId": "unt_789",
  "firstName": "Alex",
  "lastName": "Smith",
  "email": "alex@example.com",
  "status": "SCREENING",
  "source": "website"
}

Related Endpoints

GET/api/leads

POST/api/leads

GET/api/leads/:id

PUT/api/leads/:id

POST/api/leads/:id/convert

Users

User accounts that authenticate into DoorStax. Every tenant, owner, and team member has a user record.

Key Fields

Field	Type	Description
id	String	Unique identifier
email	String	Login email
name	String	Full name
role	UserRole	Assigned role
twoFactorEnabled	Boolean	2FA status
status	UserStatus	ACTIVE \| SUSPENDED \| PENDING

Example

json

{
  "id": "usr_abc123",
  "email": "user@example.com",
  "name": "Jane Doe",
  "role": "PROPERTY_MANAGER",
  "twoFactorEnabled": true,
  "status": "ACTIVE"
}

Related Endpoints

GET/api/users

GET/api/users/:id

PUT/api/users/:id

POST/api/users/invite

Expenses

Track property and unit-level expenses with flexible billing assignment. Expenses can be charged to owners, tenants, PMs, insurance, or split between parties.

Key Fields

Field	Type	Description
id	String	Unique identifier
propertyId	String	Associated property
unitId	String?	Specific unit (optional)
category	ExpenseCategory	MAINTENANCE, SERVICES, UPGRADES, TAXES, MORTGAGE, INSURANCE, PAYROLL, OTHER
amount	Decimal	Expense amount
payableBy	String	OWNER, TENANT, PM, INSURANCE, SPLIT
status	String	PENDING, APPROVED, INVOICED, PAID, WRITTEN_OFF
tenantId	String?	Assigned tenant (when payableBy = TENANT)
paymentId	String?	Linked Payment record
splitConfig	Json?	Split configuration array
recurring	Boolean	Whether this recurs monthly

Example

json

{
  "id": "exp_abc123",
  "propertyId": "prp_001",
  "category": "MAINTENANCE",
  "amount": 375.00,
  "payableBy": "TENANT",
  "status": "INVOICED",
  "tenantId": "tnt_012",
  "recurring": false
}

Related Endpoints

GET/api/expenses

POST/api/expenses

PUT/api/expenses/:id

DELETE/api/expenses/:id

POST/api/expenses/:id/approve

POST/api/expenses/:id/reject

Evictions

Track eviction proceedings from notice through resolution with full document and timeline management. 10-step status workflow with automatic tenant freeze on completion.

Key Fields

Field	Type	Description
id	String	Unique identifier
tenantId	String	Tenant being evicted
unitId	String	Unit being vacated
status	String	10-step workflow (NOTICE_PENDING through COMPLETED)
reason	String	NON_PAYMENT, LEASE_VIOLATION, PROPERTY_DAMAGE, etc.
noticeType	String?	PAY_OR_QUIT, CURE_OR_QUIT, UNCONDITIONAL_QUIT
noticeDays	Int?	Notice period in days
caseNumber	String?	Court case number
hearingDate	DateTime?	Scheduled court hearing
judgmentResult	String?	FOR_LANDLORD, FOR_TENANT, DISMISSED
outstandingBalance	Decimal?	Amount owed
resolutionType	String?	EVICTED, CURED, SETTLED, DISMISSED

Example

json

{
  "id": "evi_abc123",
  "tenantId": "tnt_012",
  "status": "CURE_PERIOD",
  "reason": "NON_PAYMENT",
  "noticeType": "PAY_OR_QUIT",
  "noticeDays": 3,
  "outstandingBalance": 3800.00
}

Related Endpoints

GET/api/evictions

POST/api/evictions

GET/api/evictions/:id

PUT/api/evictions/:id

POST/api/evictions/:id/documents

POST/api/evictions/:id/notes

Fee Schedules

Configurable fee structures that cascade from property to owner level. Controls ACH fees, management percentages, and payout calculations.

Key Fields

Field	Type	Description
id	String	Unique identifier
name	String	Schedule name (e.g., 'Premium')
achRate	Decimal	ACH transaction fee
achFeeResponsibility	String	OWNER, TENANT, or PM
managementFeePercent	Decimal	Management fee percentage
payoutFeeRate	Decimal	Payout processing rate
unitFeeRate	Decimal	Per-unit monthly fee

Example

json

{
  "id": "fsc_abc123",
  "name": "Premium",
  "achRate": 5.00,
  "achFeeResponsibility": "OWNER",
  "managementFeePercent": 8.00
}

Related Endpoints

GET/api/fee-schedules

POST/api/fee-schedules

PUT/api/fee-schedules/:id

Recurring Billing

Automatic rent payment configuration for tenants. Handles enrollment, pre-charge notifications, failure tracking, and automatic pause after max retries.

Key Fields

Field	Type	Description
id	String	Unique identifier
tenantId	String	Tenant (one per tenant)
amount	Decimal	Payment amount
dayOfMonth	Int	Day rent is charged
status	String	ACTIVE, PAUSED, CANCELLED
paymentMethod	String	CARD or ACH
failedAttempts	Int	Consecutive failures
maxRetries	Int	Max retries before pause (default 3)

Example

json

{
  "id": "rec_abc123",
  "tenantId": "tnt_012",
  "amount": 1900.00,
  "dayOfMonth": 1,
  "status": "ACTIVE",
  "paymentMethod": "CARD",
  "failedAttempts": 0
}

Related Endpoints

POST/api/payments/autopay

DELETE/api/payments/autopay

Core Objects

Properties

Key Fields

Example

Related Endpoints

Units

Key Fields

Example

Related Endpoints

Tenants

Key Fields

Example

Related Endpoints

Leases

Key Fields

Example

Related Endpoints

Payments

Key Fields

Example

Related Endpoints

Ledger Entries

Key Fields

Example

Related Endpoints

Payouts

Key Fields

Example

Related Endpoints

Owners

Key Fields

Example

Related Endpoints

Leads

Key Fields

Example

Related Endpoints

Users

Key Fields

Example

Related Endpoints

Expenses

Key Fields

Example

Related Endpoints

Evictions

Key Fields

Example

Related Endpoints

Fee Schedules

Key Fields

Example

Related Endpoints

Recurring Billing

Key Fields

Example

Related Endpoints