Skip to main content

How to Filter Leads and IntakeOpportunity Records by Date Using the modified_time Parameter (API)

Prerequisites

Before you begin, make sure you have:

  • A valid Dazos API session identifier (sessionName)

  • Access to the Leads or IntakeOpportunity module via the Dazos API

  • A REST client (such as Postman) or equivalent tool to send API requests

Overview

When filtering Leads or IntakeOpportunity records by created or modified date in the Dazos API, the date filter must not be placed inside search_params. Instead, it must be sent as a separate top-level parameter called modified_time (with an underscore).

Sending the date filter inside search_params will not work and will return unfiltered results.
​

Steps

  1. Build your request body as usual, including your sessionName, record, and page parameters.
    ​

  2. Add modified_time as a top-level parameter — not inside search_params. Use a date value in YYYY-MM-DD format.
    ​

    A single date returns all records modified on or after that date:

    {
      "sessionName": "<valid session>",
      "record": 100,
      "page": 1,
      "modified_time": "2026-09-26"
    }
  3. To filter by a date range, send both the start and end dates separated by a comma within the same modified_time value:

    {
      "sessionName": "<valid session>",
      "record": 100,
      "page": 1,
      "modified_time": "2026-09-26,2026-10-14"
    }

    This returns records modified on or after 2026-09-26 and on or before 2026-10-14.
    ​

  4. Send the request and verify that the returned records fall within your specified date range.

Result

After completing these steps, the API will return Leads or IntakeOpportunity records filtered by the date or date range you specified. Records outside the specified window will be excluded from the response.
​

Important notes:

Did this answer your question?