{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Query options","siteUrl":"https://documentation.mailgun.com","llmstxt":{"title":"Mailgun Documentation","description":"LLMS.txt containing a map of all the documentation files for Mailgun.","sections":[{"title":"Mailgun Send Documentation","description":"All of the Mailgun Send documentation.","includeFiles":["docs/mailgun/**/*.md"],"excludeFiles":["docs/mailgun/index.md"]},{"title":"Mailgun Send OAS","description":"All of the Mailgun Send API specifications.","includeFiles":["docs/mailgun/**/mailgun.yaml"]},{"title":"Mailgun Optimize Documentation","description":"All of the Mailgun Optimize documentation.","includeFiles":["docs/inboxready/**/*.md"],"excludeFiles":["docs/inboxready/index.md"]},{"title":"Mailgun Optimize OAS","description":"All of the Mailgun Optimize API specifications","includeFiles":["docs/inboxready/**/inboxready.yaml"]},{"title":"Mailgun Validate Documentation","description":"All of the Mailgun Validate documentation.","includeFiles":["docs/validate/**/*.md"],"excludeFiles":["docs/validate/index.md"]},{"title":"Mailgun Validate OAS","description":"All of the Mailgun Validate API specifications.","includeFiles":["docs/validate/**/*.yaml"]},{"title":"Mailgun Inspect Documentation","description":"All of the Mailgun Inspect documentation.","includeFiles":["docs/inspect/**/overview.md"]},{"title":"Mailgun Inspect OAS","description":"All of the Mailgun Inspect API specifications.","includeFiles":["docs/inspect/**/*.yaml"]}]},"description":"Email query options are used to search, filter, and sort email event data, helping you quickly find and analyze the email activity you care about."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"query-options","__idx":0},"children":["Query Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["URL parameters allow you to manipulate the results of your query."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["begin"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The beginning of the search time range. It can be specified as a string (see date-format) or linux epoch seconds. Refer to Time Range for details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["end"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The end of the search time range. It can be specified as a string (see ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date-format"]},") or linux epoch seconds. Refer to Time Range for details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ascending"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Defines the direction of the search time range and must be provided if the range end time is not specified. Can be either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["yes"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["no"]},". Refer to Time Range for details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["limit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of entries to return. (300 max)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["field"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field"]}," is the name of the Filter Field. The value of the parameter should be a valid Filter Expression. Several field filters can be specified in one request. If the same field is mentioned, more than once, then all its filter expressions are combined with AND operator."]}]}]}]}]}]},"headings":[{"value":"Query Options","id":"query-options","depth":1}],"frontmatter":{"seo":{"title":"Query options","description":"Email query options are used to search, filter, and sort email event data, helping you quickly find and analyze the email activity you care about."}},"lastModified":"2026-10-28T19:46:32.475Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/mailgun/user-manual/events/query-options","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}