> ## Documentation Index
> Fetch the complete documentation index at: https://help.broadstripes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search event info using dates or a timeframe

> Use the search builder to find contacts based on when an event step was checked, using dates or natural language timeframes like "last week."

## Overview

The Broadstripes search builder lets you search for very specific event-related information, including who has attended a rally in the last month or signed a card in the past week. In Broadstripes, that type of information is recorded as **events** and **event steps**. Keep in mind that events are created and customized by users and admins, so each project will have its own unique events. (Learn more in the [creating events](/docs/customize/create-events-to-track-goals) article.)

In this article, we'll show you how to search based on an event called "**Card**" to find all the people who have signed a card within a specific timeframe.

## Build a search to capture events in time

In another article, we [built a search to look at people who had not yet signed cards](/docs/search/search-by-event-step). For this article, we're going to assume it's a week later, and we want to see how many new cards have been signed since we ran that previous search. Here's how:

1. Start a new search by clicking the **Search Builder** button to the right of the search box at the top of the page.

   <img src="https://mintcdn.com/broadstripes/1ASOAs0R6p_8mVU9/images/search/search-builder-button.png?fit=max&auto=format&n=1ASOAs0R6p_8mVU9&q=85&s=46ab43457ab7d48ac48edcaa288844b6" alt="Search bar with the Search Builder button" width="775" height="36" data-path="images/search/search-builder-button.png" />

2. A **search building panel** opens below the search box.

3. Since we want to limit our search to workers who have signed a card in the last week, choose the **Card - Signed** event step from the left-hand drop-down menu in the search builder.

4. In the middle drop-down menu, select **was checked on or after**.

5. In the right-hand text box, type **last week**.

   <img src="https://mintcdn.com/broadstripes/1ASOAs0R6p_8mVU9/images/search/search-builder-event-date-filled.png?fit=max&auto=format&n=1ASOAs0R6p_8mVU9&q=85&s=62d70a8155e316ea2a613881702a9ae7" alt="Search builder with Card - Signed was checked on or after last week" width="1207" height="242" data-path="images/search/search-builder-event-date-filled.png" />

<Info>
  Broadstripes accepts natural language date terms like "last week," "6 months ago," or "yesterday." You can also use a calendar date like "2/20/2025."
</Info>

6. Click the **Search** button to run the search. All contacts who have had their card signed within the specified timeframe display in the **Search Results** page.

7. To see a count of the total number of contacts in the search results at a glance, check the **Showing X contacts** indicator in the upper-right corner of the search results page.

   <img src="https://mintcdn.com/broadstripes/1ASOAs0R6p_8mVU9/images/search/search-event-date-results.png?fit=max&auto=format&n=1ASOAs0R6p_8mVU9&q=85&s=81bed2b75e56310e0417b647737acd28" alt="Search results showing contacts with Card - Signed checked on or after a date" width="1245" height="480" data-path="images/search/search-event-date-results.png" />

## Date operators for events

When you select an event or event step keyword in the search builder, the following date-based operators are available:

| Operator                     | Description                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------ |
| **was checked on**           | Matches contacts where the event step was checked on a specific date           |
| **was not checked on**       | Excludes contacts where the event step was checked on a specific date          |
| **was checked before**       | Matches contacts where the event step was checked before a specific date       |
| **was checked after**        | Matches contacts where the event step was checked after a specific date        |
| **was checked on or before** | Matches contacts where the event step was checked on or before a specific date |
| **was checked on or after**  | Matches contacts where the event step was checked on or after a specific date  |

## Date value examples

You can enter dates in multiple formats:

| Format                      | Example                                        |
| --------------------------- | ---------------------------------------------- |
| Natural language (relative) | last week, 6 months ago, yesterday, 2 days ago |
| Calendar date               | 2/20/2025, 12/01/2024                          |
