Filtering Listings by Status

When working with listings in the system, you have three different ways to filter by status. Each method serves different purposes and provides varying levels of detail.

Overview of Status Filtering Options

1. status (Binary Filter)

The status parameter provides a simple binary filter for listings:

• A = Available (On-Market)
• U = Unavailable (Off-Market)

This is the most basic status filter, giving you a high-level view of listing availability.

When to use: When you need a quick overview of which listings are available versus unavailable.

2. lastStatus (Detailed Sub-Status)

The lastStatus parameter acts as a sub-status that provides more granular information about a listing's current state. It's designed to work in combination with the status parameter to give you detailed breakdowns of listings that are either Available (A) or Unavailable (U).

Important characteristics:

• There is no predetermined sequence for lastStatus values
• Values can change in any order (e.g., New → Sc → Sld → Sc)
• Provides detailed insight into the listing's current condition
• Some lastStatus values are specific to certain status values (A or U)
• Should be used together with the status parameter for optimal filtering

For a complete list of lastStatus values and their definitions, see: lastStatus Definitions

When to use: When you need detailed information about the specific state or condition of listings within Available or Unavailable categories.

3. standardStatus (RESO-Compliant Standard)

The standardStatus parameter uses familiar status terminology such as:

• Active
• Pending
• Closed
• Cancelled
• And other standard status labels

This is the RESO-compliant approach and is more widely adopted across the industry, making it the recommended method for most use cases.

Important note: When using standardStatus as your filter, the status and lastStatus parameters become irrelevant and should not be used simultaneously.

When to use: For industry-standard filtering that's widely recognized and RESO-compliant. This is the preferred approach for new implementations.

Choosing the Right Status Filter

Best Practices

1. Choose the right approach for your needs:

• Recommended: Use standardStatus for RESO-compliant, industry-standard filtering
• Legacy: Use status and lastStatus together for detailed legacy workflow tracking

2. Don't mix approaches - Use either standardStatus OR the status/lastStatus combination, never both
3. When using legacy filtering:

• Always combine status with lastStatus for meaningful results
• Some lastStatus values are specific to certain status values (A or U)

4. Refer to documentation - For lastStatus values, always check the definitions guide to ensure you're using the correct values

Examples

RESO-compliant standard filtering (Recommended):

?standardStatus=Active     // Shows active listings
?standardStatus=Pending    // Shows pending listings
?standardStatus=Closed     // Shows closed listings

Legacy combined filtering:

?status=A&lastStatus=New   // Shows active listings
?status=U&lastStatus=Sc    // Shows pending listings
?status=U&lastStatus=Sld   // Shows closed listings

Updated on: 05/08/2025