Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.
GET
/
public
/
emails
cURL
curl --request GET \ --url https://app.revyops.com/api/public/emails \ --header 'X-API-KEY: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"RevyOps","colors":{"primary":"#1E3A63","light":"#30BDC6","dark":"#1E3A63"},"logo":{"light":"https://mintcdn.com/revyops/WYIqYgA10R3-hgk7/logo/light.png?fit=max\u0026auto=format\u0026n=WYIqYgA10R3-hgk7\u0026q=85\u0026s=9648ff5116ab0f4221a86fe449d81b30","dark":"https://mintcdn.com/revyops/WYIqYgA10R3-hgk7/logo/dark.png?fit=max\u0026auto=format\u0026n=WYIqYgA10R3-hgk7\u0026q=85\u0026s=904f6018758fe669cc2f3c8cf728c59c","href":"https://revyops.com"},"favicon":"https://mintcdn.com/revyops/WYIqYgA10R3-hgk7/logo/favicon.ico?fit=max\u0026auto=format\u0026n=WYIqYgA10R3-hgk7\u0026q=85\u0026s=331e45bd7f0f4a6e26ac787febba19f2","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"mailto:support@revyops.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.revyops.com"}},"footer":{"socials":{"website":"https://revyops.com"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"revyops","hasAudioNarration":false,"actualSubdomain":"revyops","customDomains":["docs.revyops.com"],"gitSource":{"type":"github","owner":"revyops-llc","repo":"revyops","deployBranch":"master","contentDirectory":"docs/mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3616ab5de186da748d416","collectionId":"0d7fee30-3f49-4522-9e04-5137ad994013","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3616ab5de186da748d416"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae3616ab5de186da748d416","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":169},{"language":"default","tag":"Documentation","count":84},{"language":"default","tag":"Integrations","count":44},{"language":"default","tag":"Data Model","count":26},{"language":"default","tag":"User Guide","count":20},{"language":"default","tag":"Activities","count":15},{"language":"default","tag":"MCP","count":15},{"language":"default","tag":"Companies","count":14},{"language":"default","tag":"Contacts","count":14},{"language":"default","tag":"Objects","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/emails/list-emails","slug":"/api-reference/emails/list-emails","pageMetadata":{"title":"List Emails","openapi":"GET /public/emails","description":"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.","href":"/api-reference/emails/list-emails"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Emails","openapi":"GET /public/emails","description":"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.","href":"/api-reference/emails/list-emails"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"Search for emails","description":"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.","parameters":["6003c8e3-6c2d-4448-b1fe-1f0ca73b8501","cbfc3d83-c4a7-4e27-9803-7d45cce9f58b","c4d87ccd-9d10-42a7-9adc-3b62ed17dc19","7754d579-331b-464e-b0cf-0873d78ce3bd"],"tags":["public"],"responses":{"200":"c612dd34-8f18-4971-bbd0-379001043e81","403":"a88287c2-9759-4bda-b5fb-3fd790acc32d","500":"76fafb3d-3fc6-4cbd-9e44-9483673de792"},"method":"get","type":"path","servers":["bac0704e-7eb9-4561-a977-88e3d3b409e4"],"security":["71944567-d801-4012-9a5b-de18adf19d78"],"path":"/public/emails","baseUrlOptions":["https://app.revyops.com/api"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6003c8e3-6c2d-4448-b1fe-1f0ca73b8501":{"in":"query","name":"campaign_id","schema":{"type":"string","description":"Filter emails by campaign ID","uniqueKey":"","typeLabel":"string"},"description":"Filter emails by campaign ID"},"cbfc3d83-c4a7-4e27-9803-7d45cce9f58b":{"in":"query","name":"contact_email","schema":{"type":"string","description":"Filter emails by contact email","uniqueKey":"","typeLabel":"string"},"description":"Filter emails by contact email"},"c4d87ccd-9d10-42a7-9adc-3b62ed17dc19":{"in":"query","name":"origin","schema":{"type":"string","description":"Filter emails by origin","uniqueKey":"","typeLabel":"string"},"description":"Filter emails by origin"},"7754d579-331b-464e-b0cf-0873d78ce3bd":{"in":"query","name":"subject","schema":{"type":"string","description":"Filter emails by subject","uniqueKey":"","typeLabel":"string"},"description":"Filter emails by subject"}},"responses":{"c612dd34-8f18-4971-bbd0-379001043e81":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"integer"},"updated_time":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"items.[INDEX].updated_time","typeLabel":"string\u003cdate-time>"},"email_type":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].email_type","typeLabel":"string"},"origin":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].origin","typeLabel":"string"},"email_timestamp":{"type":"string","format":"date-time","uniqueKey":"items.[INDEX].email_timestamp","typeLabel":"string\u003cdate-time>"},"contact_email":{"oneOf":[{"type":"string","format":"email","uniqueKey":"items.[INDEX].contact_email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"string","maxLength":0,"uniqueKey":"items.[INDEX].contact_email.oneOf.1","typeLabel":"string"}],"uniqueKey":"items.[INDEX].contact_email","typeLabel":"string\u003cemail> | string"},"contact_id":{"type":"integer","uniqueKey":"items.[INDEX].contact_id","typeLabel":"integer"},"agent_email":{"oneOf":[{"type":"string","format":"email","uniqueKey":"items.[INDEX].agent_email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"string","maxLength":0,"uniqueKey":"items.[INDEX].agent_email.oneOf.1","typeLabel":"string"}],"uniqueKey":"items.[INDEX].agent_email","typeLabel":"string\u003cemail> | string"},"subject":{"type":"string","uniqueKey":"items.[INDEX].subject","typeLabel":"string"},"body_text":{"type":"string","uniqueKey":"items.[INDEX].body_text","typeLabel":"string"},"body_html":{"type":"string","uniqueKey":"items.[INDEX].body_html","typeLabel":"string"},"campaign_id":{"type":"string","uniqueKey":"items.[INDEX].campaign_id","typeLabel":"string"},"campaign_name":{"type":"string","uniqueKey":"items.[INDEX].campaign_name","typeLabel":"string"},"interested":{"type":"boolean","uniqueKey":"items.[INDEX].interested","typeLabel":"boolean"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"isRequired":true,"uniqueKey":"items.[INDEX].custom_fields.items.[INDEX].id","typeLabel":"integer"},"updated_time":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"items.[INDEX].custom_fields.items.[INDEX].updated_time","typeLabel":"string\u003cdate-time>"},"field_name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].custom_fields.items.[INDEX].field_name","typeLabel":"string"},"field_value":{"type":"string","maxLength":2500,"isRequired":true,"uniqueKey":"items.[INDEX].custom_fields.items.[INDEX].field_value","typeLabel":"string"}},"required":["field_name","field_value","id","updated_time"],"uniqueKey":"items.[INDEX].custom_fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"items.[INDEX].custom_fields","typeLabel":"object[]"}},"required":["email_type","id","origin","updated_time"],"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"id":123,"updated_time":"2023-11-07T05:31:56Z","email_type":"\u003cstring>","origin":"\u003cstring>","email_timestamp":"2023-11-07T05:31:56Z","contact_email":"jsmith@example.com","contact_id":123,"agent_email":"jsmith@example.com","subject":"\u003cstring>","body_text":"\u003cstring>","body_html":"\u003cstring>","campaign_id":"\u003cstring>","campaign_name":"\u003cstring>","interested":true,"custom_fields":[{"id":123,"updated_time":"2023-11-07T05:31:56Z","field_name":"\u003cstring>","field_value":"\u003cstring>"}]}]}},"exampleType":"generated"}},"description":"The list of emails was successfully retrieved.","exampleType":"generated"},"a88287c2-9759-4bda-b5fb-3fd790acc32d":{"description":"Forbidden. Missing authentication credentials or invalid API key.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"76fafb3d-3fc6-4cbd-9e44-9483673de792":{"description":"Internal Server Error. An unexpected error occurred on the server.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"71944567-d801-4012-9a5b-de18adf19d78":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"bac0704e-7eb9-4561-a977-88e3d3b409e4":{"url":"https://app.revyops.com/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"revyops","siteName":"RevyOps","title":"List Emails - RevyOps","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-27T17:37:53.057Z","originalFileLocation":"api-reference/emails/list-emails.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\">\u003cmeta data-mint-head name=\"application-name\" content=\"RevyOps\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Emails - RevyOps\">\u003cmeta data-mint-head property=\"og:description\" content=\"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"RevyOps\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.revyops.com/api-reference/emails/list-emails\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://revyops.mintlify.app/_mintlify/api/og/v2?division=Emails\u0026amp;title=List+Emails\u0026amp;description=Allows+you+to+search+for+emails+in+the+system.+You+can+filter+the+search+using+query+parameters%2C+and+the+search+will+return+emails+that+match+the+specified+crit\u0026amp;theme=509ca470676824bd0b089ca2\u0026amp;signature=b1ff3e5a1c5c6e05c92efcfd5060f53d167626ce344b67c507ed0bff52e3d07d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Emails - RevyOps\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://revyops.mintlify.app/_mintlify/api/og/v2?division=Emails\u0026amp;title=List+Emails\u0026amp;description=Allows+you+to+search+for+emails+in+the+system.+You+can+filter+the+search+using+query+parameters%2C+and+the+search+will+return+emails+that+match+the+specified+crit\u0026amp;theme=509ca470676824bd0b089ca2\u0026amp;signature=b1ff3e5a1c5c6e05c92efcfd5060f53d167626ce344b67c507ed0bff52e3d07d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/revyops/7rfJ7Pd6htzWOdGJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"RevyOps\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E3A63\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.revyops.com/api-reference/emails/list-emails\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/emails/list-emails.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.revyops.com/#organization\",\"name\":\"RevyOps\",\"url\":\"https://docs.revyops.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/revyops/WYIqYgA10R3-hgk7/logo/light.png?fit=max\u0026auto=format\u0026n=WYIqYgA10R3-hgk7\u0026q=85\u0026s=9648ff5116ab0f4221a86fe449d81b30\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.revyops.com#website\",\"name\":\"RevyOps\",\"url\":\"https://docs.revyops.com\",\"publisher\":{\"@id\":\"https://docs.revyops.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.revyops.com/api-reference/emails/list-emails#webpage\",\"url\":\"https://docs.revyops.com/api-reference/emails/list-emails\",\"name\":\"List Emails\",\"description\":\"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\",\"dateModified\":\"2026-02-27T17:37:53.057Z\",\"isPartOf\":{\"@id\":\"https://docs.revyops.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.revyops.com/api-reference/emails/list-emails#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.revyops.com/api-reference/emails/list-emails#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"RevyOps\",\"item\":\"https://docs.revyops.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Emails\",\"item\":\"https://docs.revyops.com/api-reference/emails/list-emails\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.revyops.com/api-reference/emails/list-emails#apireference\",\"headline\":\"List Emails\",\"name\":\"List Emails\",\"description\":\"Allows you to search for emails in the system. You can filter the search using query parameters, and the search will return emails that match the specified criteria.\",\"url\":\"https://docs.revyops.com/api-reference/emails/list-emails\",\"mainEntityOfPage\":{\"@id\":\"https://docs.revyops.com/api-reference/emails/list-emails#webpage\"},\"dateModified\":\"2026-02-27T17:37:53.057Z\",\"publisher\":{\"@id\":\"https://docs.revyops.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.revyops.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"RevyOps\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"RevyOps","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Data Model","pages":[{"title":"Data Model","href":"/data-model/overview"}]},{"tab":"API Reference","anchors":[{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"API Reference","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Filter Parameters","href":"/api-reference/filtering"},{"title":"HTTP Response Codes","href":"/api-reference/response-codes"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Dates and Timezones","href":"/api-reference/dates-and-timezones"},{"title":"Who Am I","openapi":"GET /public/whoami","href":"/api-reference/whoami"},{"title":"List Integrations","openapi":"GET /public/integrations","href":"/api-reference/integrations"}]},{"group":"Contacts","pages":[{"title":"List Contacts","openapi":"GET /public/v2/contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Create Contact","openapi":"POST /public/v2/contacts","href":"/api-reference/contacts/create-contact"},{"title":"Get Contact","openapi":"GET /public/v2/contacts/{contact_id}","href":"/api-reference/contacts/get-contact"},{"title":"Update Contact","openapi":"PATCH /public/v2/contacts/{contact_id}","href":"/api-reference/contacts/update-contact"},{"title":"Delete Contact","openapi":"DELETE /public/contacts/{contact_id}","href":"/api-reference/contacts/delete-contact"},{"title":"Lookup by Custom Field","openapi":"GET /public/v2/contacts/lookup-by-custom-field","href":"/api-reference/contacts/lookup-by-custom-field"},{"title":"Add Custom Field","openapi":"POST /public/contacts/{contact_id}/custom-fields","href":"/api-reference/contacts/add-custom-field"},{"title":"Update Custom Field","openapi":"PATCH /public/contacts/{contact_id}/custom-fields/{field_id}","href":"/api-reference/contacts/update-custom-field"},{"title":"Delete Custom Field","openapi":"DELETE /public/contacts/{contact_id}/custom-fields/{field_id}","href":"/api-reference/contacts/delete-custom-field"},{"title":"Create or Update Contact","openapi":"PUT /public/v2/contacts","href":"/api-reference/contacts/upsert-contact"},{"title":"List Master List Contacts","openapi":"GET /public/v2/contacts-master-list","href":"/api-reference/contacts/list-master-list"},{"title":"Get Master List Contact","openapi":"GET /public/v2/contacts-master-list/{contact_id}","href":"/api-reference/contacts/get-master-list-contact"},{"title":"Master List Lookup by Custom Field","openapi":"GET /public/v2/contacts-master-list/lookup-by-custom-field","href":"/api-reference/contacts/master-list-lookup-by-custom-field"},{"title":"Update Contact Across Workspaces","openapi":"PATCH /public/contacts-master-list/global-update","href":"/api-reference/contacts/global-update"}]},{"group":"Companies","pages":[{"title":"List Companies","openapi":"GET /public/v2/companies","href":"/api-reference/companies/list-companies"},{"title":"Create Company","openapi":"POST /public/v2/companies","href":"/api-reference/companies/create-company"},{"title":"Get Company","openapi":"GET /public/v2/companies/{company_id}","href":"/api-reference/companies/get-company"},{"title":"Update Company","openapi":"PATCH /public/v2/companies/{company_id}","href":"/api-reference/companies/update-company"},{"title":"Delete Company","openapi":"DELETE /public/companies/{company_id}","href":"/api-reference/companies/delete-company"},{"title":"Lookup by Custom Field","openapi":"GET /public/v2/companies/lookup-by-custom-field","href":"/api-reference/companies/lookup-by-custom-field"},{"title":"Add Custom Field","openapi":"POST /public/companies/{company_id}/custom-fields","href":"/api-reference/companies/add-custom-field"},{"title":"Update Custom Field","openapi":"PATCH /public/companies/{company_id}/custom-fields/{field_id}","href":"/api-reference/companies/update-custom-field"},{"title":"Delete Custom Field","openapi":"DELETE /public/companies/{company_id}/custom-fields/{field_id}","href":"/api-reference/companies/delete-custom-field"},{"title":"Create or Update Company","openapi":"PUT /public/v2/companies","href":"/api-reference/companies/upsert-company"},{"title":"List Master List Companies","openapi":"GET /public/v2/companies-master-list","href":"/api-reference/companies/list-master-list"},{"title":"Get Master List Company","openapi":"GET /public/v2/companies-master-list/{company_id}","href":"/api-reference/companies/get-master-list-company"},{"title":"Master List Lookup by Custom Field","openapi":"GET /public/v2/companies-master-list/lookup-by-custom-field","href":"/api-reference/companies/master-list-lookup-by-custom-field"},{"title":"Update Company Across Workspaces","openapi":"PATCH /public/companies-master-list/global-update","description":"Updates the details of a company by domain across all workspaces in the agency. Applies the same changes to every workspace that has a company with this domain.","href":"/api-reference/companies/global-update"}]},{"group":"Emails","pages":[{"title":"List Emails","openapi":"GET /public/emails","href":"/api-reference/emails/list-emails"},{"title":"Create Email","openapi":"POST /public/emails","description":"Creates a new email in the system with the provided details.","href":"/api-reference/emails/create-email"},{"title":"Get Email","openapi":"GET /public/emails/{email_id}","href":"/api-reference/emails/get-email"},{"title":"Delete Email","openapi":"DELETE /public/emails/{email_id}","href":"/api-reference/emails/delete-email"},{"title":"Set Interested","openapi":"POST /public/emails/set-interested","href":"/api-reference/emails/set-interested"},{"title":"Add Email Custom Field","openapi":"POST /public/emails/{email_id}/custom-fields","href":"/api-reference/emails/add-custom-field"},{"title":"Delete Email Custom Field","openapi":"DELETE /public/emails/{email_id}/custom-fields/{field_id}","href":"/api-reference/emails/delete-custom-field"}]},{"group":"People","pages":[{"title":"List People","openapi":"GET /public/people","href":"/api-reference/people/list-people"},{"title":"Look Up Person","openapi":"GET /public/people/lookup","href":"/api-reference/people/lookup-person"},{"title":"Get Person","openapi":"GET /public/people/{person_id}","href":"/api-reference/people/get-person"},{"title":"Create or Update Person","openapi":"POST /public/people","href":"/api-reference/people/create-person"},{"title":"Update Person","openapi":"PATCH /public/people/{person_id}","href":"/api-reference/people/update-person"},{"title":"Merge People","openapi":"POST /public/people/merge","href":"/api-reference/people/merge-people"},{"title":"Split Person","openapi":"POST /public/people/split","href":"/api-reference/people/split-person"}]},{"group":"Opportunities","pages":[{"title":"Create Opportunity","openapi":"POST /public/v2/opportunities","href":"/api-reference/opportunities/create-opportunity"},{"title":"Get Opportunity","openapi":"GET /public/v2/opportunities/{opportunity_id}","href":"/api-reference/opportunities/get-opportunity"},{"title":"Update Opportunity","openapi":"PATCH /public/v2/opportunities/{opportunity_id}","href":"/api-reference/opportunities/update-opportunity"},{"title":"Delete Opportunity","openapi":"DELETE /public/v2/opportunities/{opportunity_id}","href":"/api-reference/opportunities/delete-opportunity"},{"title":"List Opportunity Mappings","openapi":"GET /public/opportunities/mappings","href":"/api-reference/opportunities/list-mappings"},{"title":"Save Opportunity Mappings","openapi":"POST /public/opportunities/mappings","href":"/api-reference/opportunities/save-mappings"}]},{"group":"Custom Fields","pages":[{"title":"List Custom Field Schema","openapi":"GET /public/custom-fields/schema","href":"/api-reference/custom-fields/list-schema"},{"title":"Define Custom Field","openapi":"POST /public/custom-fields/schema","href":"/api-reference/custom-fields/define-field"}]},{"group":"Activities","pages":[{"title":"List Activity Types","openapi":"GET /public/activities/types/","href":"/api-reference/activities/list-activity-types"},{"title":"Create Activity Type","openapi":"POST /public/activities/types/","href":"/api-reference/activities/create-activity-type"},{"title":"Log Custom Activity","openapi":"POST /public/activities/custom/","href":"/api-reference/activities/log-custom-activity"},{"title":"Log Activities in Bulk","openapi":"POST /public/activities/batch/","href":"/api-reference/activities/log-activity-batch"},{"title":"Get Batch Result","openapi":"GET /public/activities/batch/{batch_id}/","href":"/api-reference/activities/get-activity-batch"},{"title":"Update Custom Activity Type","openapi":"PATCH /public/activities/custom/","href":"/api-reference/activities/update-custom-activity"},{"title":"Delete Custom Activity Type","openapi":"DELETE /public/activities/custom/","href":"/api-reference/activities/delete-custom-activity"},{"title":"Get Activity","openapi":"GET /public/activities/{activity_id}/","href":"/api-reference/activities/get-activity"},{"title":"Update Activity","openapi":"PATCH /public/activities/{activity_id}/","href":"/api-reference/activities/update-activity"},{"title":"Delete Activity","openapi":"DELETE /public/activities/{activity_id}/","href":"/api-reference/activities/delete-activity"},{"title":"Log Call","openapi":"POST /public/activities/standard/call/","href":"/api-reference/activities/log-call"},{"title":"Log Email","openapi":"POST /public/activities/standard/email/","href":"/api-reference/activities/log-email"},{"title":"Log LinkedIn Message","openapi":"POST /public/activities/standard/linkedin_message/","href":"/api-reference/activities/log-linkedin-message"},{"title":"Log SMS","openapi":"POST /public/activities/standard/sms/","href":"/api-reference/activities/log-sms"},{"title":"Log WhatsApp Message","openapi":"POST /public/activities/standard/whatsapp/","href":"/api-reference/activities/log-whatsapp"}]},{"group":"Webhooks","pages":[{"title":"Instantly Webhook","openapi":"POST /public/instantly-webhook/{client_id}","href":"/api-reference/webhooks/instantly"},{"title":"SmartLead Webhook","openapi":"POST /public/smartlead-webhook/{client_id}","href":"/api-reference/webhooks/smartlead"},{"title":"Lemlist Webhook","openapi":"POST /public/lemlist-webhook/{client_id}","href":"/api-reference/webhooks/lemlist"},{"title":"EmailBison Webhook","openapi":"POST /public/emailbison-webhook/{client_id}","href":"/api-reference/webhooks/emailbison"},{"title":"PlusVibe Webhook","openapi":"POST /public/plusvibe-webhook/{client_id}","href":"/api-reference/webhooks/plusvibe"},{"title":"HubSpot Webhook","openapi":"POST /public/hubspot-webhook/{client_id}","href":"/api-reference/webhooks/hubspot"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"List Emails - RevyOps","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}