---
title: "events(matching:)"
framework: eventkit
role: symbol
role_heading: Instance Method
path: "eventkit/ekeventstore/events(matching:)"
---

# events(matching:)

Finds all events that match a given predicate.

## Declaration

```swift
func events(matching predicate: NSPredicate) -> [EKEvent]
```

## Parameters

- `predicate`: A search predicate created with doc://com.apple.eventkit/documentation/EventKit/EKEventStore/predicateForEvents(withStart:end:calendars:).

## Mentioned in

Retrieving events and reminders

## Return Value

Return Value An array of events that match predicate.

## Discussion

Discussion Only committed events are included in the results. To include events saved using save(_:span:commit:) with the commit parameter set to false, call commit() first. This method is synchronous. For asynchronous behavior, run the method on another thread with dispatch_async or Operation.

## See Also

### Searching calendars

- [enumerateEvents(matching:using:)](eventkit/ekeventstore/enumerateevents(matching:using:).md)
- [fetchReminders(matching:completion:)](eventkit/ekeventstore/fetchreminders(matching:completion:).md)
- [cancelFetchRequest(_:)](eventkit/ekeventstore/cancelfetchrequest(_:).md)
- [predicateForEvents(withStart:end:calendars:)](eventkit/ekeventstore/predicateforevents(withstart:end:calendars:).md)
- [predicateForReminders(in:)](eventkit/ekeventstore/predicateforreminders(in:).md)
- [predicateForCompletedReminders(withCompletionDateStarting:ending:calendars:)](eventkit/ekeventstore/predicateforcompletedreminders(withcompletiondatestarting:ending:calendars:).md)
- [predicateForIncompleteReminders(withDueDateStarting:ending:calendars:)](eventkit/ekeventstore/predicateforincompletereminders(withduedatestarting:ending:calendars:).md)
- [EKEventSearchCallback](eventkit/ekeventsearchcallback.md)