How to Filter Current Residents Using the /residents Endpoint

Last updated: January 9, 2025

While there isn't a direct "current residents" filter available on the /residents endpoint, you can effectively filter for active/current residents by examining the lease status associated with each resident. Here's how to approach this:

Using Lease Status to Determine Current Residents

1. Access the /leases endpoint with the status_normalized filter to retrieve lease data for leases of a specific case (likely ACTIVE).

2. If not filtering, look for the status_normalized field within each lease object.

3. For each lease, examine the residents_meta_data array within the lease object. Each of these residents are associated with the lease.

Understanding "Current" Residents

The concept of a "current" resident can vary depending on the property management system and specific use case. Consider the following when defining "current":

  • Is the resident active on their current lease?

  • Has the resident moved to another lease within the same property?

  • Is the resident still living at the property in general?

  • Is the status relative to a specific unit or lease?

Additional Considerations

When working with resident data, you may also need to consider:

  • Handling residents with multiple leases or complex residency histories

  • How does your use case defined being a "current" resident

If you need more specific guidance on these topics or have questions about implementing this filtering approach, please contact our support team for further assistance.