Each key carries scopes chosen when it is created: candidates:read, candidates:write, assessments:read, assessments:write, problems:read, problems:write, results:read. Keys created before scopes existed have full access. A request with a key that lacks an operation's scope returns 403 naming the missing scope.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ropes Docs","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/ropes/yLckSC5FeL4Ln3H7/logo/ropes_logo.svg?fit=max\u0026auto=format\u0026n=yLckSC5FeL4Ln3H7\u0026q=85\u0026s=d2e2621b500af139561039d3a77b2183","dark":"https://mintcdn.com/ropes/yLckSC5FeL4Ln3H7/logo/ropes_logo.svg?fit=max\u0026auto=format\u0026n=yLckSC5FeL4Ln3H7\u0026q=85\u0026s=d2e2621b500af139561039d3a77b2183"},"favicon":"https://mintcdn.com/ropes/yLckSC5FeL4Ln3H7/logo/ropes_logo.svg?fit=max\u0026auto=format\u0026n=yLckSC5FeL4Ln3H7\u0026q=85\u0026s=d2e2621b500af139561039d3a77b2183","navbar":{"links":[{"href":"mailto:support@ropes.ai","label":"Support"}],"primary":{"type":"button","label":"Visit Site","href":"https://ropes.ai"}},"footer":{"socials":{"x":"https://x.com/ropes_ai","linkedin":"https://www.linkedin.com/company/ropes-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ropes","hasAudioNarration":false,"actualSubdomain":"ropes","customDomains":["docs.ropes.ai"],"gitSource":{"type":"github","owner":"ken-schu","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ada5adcfe532be680f37936","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Endpoints","count":24},{"language":"default","tag":"Problems","count":8},{"language":"default","tag":"Candidates","count":5},{"language":"default","tag":"Results","count":4},{"language":"default","tag":"Screens","count":4},{"language":"default","tag":"Documentation","count":2},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"Scout","count":2},{"language":"default","tag":"Usage","count":1}]},"assistantConfig":{},"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":"rbac-expansion","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/candidates/get-candidate-by-email","slug":"/api-reference/candidates/get-candidate-by-email","pageMetadata":{"title":"Get Candidate by Email","description":"Get details for a specific candidate by email, including associated interview IDs\n\n**Required scope:** `candidates:read`","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates/email/{email}","href":"/api-reference/candidates/get-candidate-by-email","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Get details for a specific candidate by email, including associated interview IDs\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"candidates:read\"\n })]\n })]\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":"Get Candidate by Email","description":"Get details for a specific candidate by email, including associated interview IDs\n\n**Required scope:** `candidates:read`","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates/email/{email}","href":"/api-reference/candidates/get-candidate-by-email","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Get details for a specific candidate by email, including associated interview IDs\n\n**Required scope:** `candidates:read`","summary":"Get Candidate by Email","tags":["Candidates"],"security":["48ef4edf-0ed2-415e-8599-82272ff5cabd"],"x-required-scope":"candidates:read","parameters":["5c16a2cc-bf30-4f81-9188-b2c02053f16a"],"responses":{"200":"25dd51dd-a19c-4354-8d62-f0860815a0c0","400":"c3254a62-2be2-432b-b99c-1c0de70a3f2e","401":"2b799837-39f3-4928-a61c-de0428150787","403":"564a8388-c658-4e70-8758-97656c63f2dc","404":"71d6ff89-409c-49c0-b035-3efb1d927193","429":"1a3fceef-641c-4e3a-83e2-556257a6f244","500":"2fbe973b-28ab-446e-bf5c-d8dcf971f4af"},"method":"get","type":"path","servers":["ce60098d-e033-4f14-a9ee-e2533a87f962","e9ca913f-fa71-402f-b3ac-efc6d99ebcb6"],"path":"/api/public/candidates/email/{email}","baseUrlOptions":["https://api.ropes.ai","http://localhost:3001"],"title":"Get Candidate by Email","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5c16a2cc-bf30-4f81-9188-b2c02053f16a":{"schema":{"type":"string","description":"The email address of the candidate","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The email address of the candidate","name":"email","in":"path"}},"responses":{"25dd51dd-a19c-4354-8d62-f0860815a0c0":{"description":"Successfully retrieved candidate details with interviews","content":{"application/json":{"schema":{"type":"object","properties":{"candidate":{"type":"object","description":"Candidate details with interviews","required":["interviewIds","name","email","createdAt","identifier","status"],"properties":{"name":{"type":"string","description":"The full name of the candidate","isRequired":true,"uniqueKey":"candidate.name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"The email address of the candidate","isRequired":true,"uniqueKey":"candidate.email","typeLabel":"string\u003cemail>"},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the candidate was created","isRequired":true,"uniqueKey":"candidate.createdAt","typeLabel":"string\u003cdate-time>"},"identifier":{"type":"string","description":"Unique identifier for the candidate","isRequired":true,"uniqueKey":"candidate.identifier","typeLabel":"string"},"status":{"type":"string","enum":["Not Assigned","Assigned","Expired","Completed","Error"],"description":"Current status of the candidate","isRequired":true,"uniqueKey":"candidate.status","typeLabel":"enum\u003cstring>"},"interviewIds":{"type":"array","items":{"type":"string","uniqueKey":"candidate.interviewIds.items.[INDEX]","typeLabel":"string"},"description":"Array of interview identifiers","isRequired":true,"uniqueKey":"candidate.interviewIds","typeLabel":"string[]"},"integrationSource":{"type":"string","description":"Integration source that created this candidate","uniqueKey":"candidate.integrationSource","typeLabel":"string"},"externalId":{"type":"string","description":"External ID from the integration source (e.g., ATS candidate ID)","uniqueKey":"candidate.externalId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"candidate","typeLabel":"object"}},"required":["candidate"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"candidate":{"name":"\u003cstring>","email":"jsmith@example.com","createdAt":"2023-11-07T05:31:56Z","identifier":"\u003cstring>","status":"Not Assigned","interviewIds":["\u003cstring>"],"integrationSource":"\u003cstring>","externalId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c3254a62-2be2-432b-b99c-1c0de70a3f2e":{"description":"Bad request - No email provided","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Error message (alternative field)","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2b799837-39f3-4928-a61c-de0428150787":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Error message (alternative field)","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"564a8388-c658-4e70-8758-97656c63f2dc":{"description":"Forbidden - API key is missing the required scope","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"71d6ff89-409c-49c0-b035-3efb1d927193":{"description":"Candidate not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Error message (alternative field)","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1a3fceef-641c-4e3a-83e2-556257a6f244":{"description":"Rate limit exceeded - contact support@ropes.ai for further assistance.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Error message (alternative field)","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2fbe973b-28ab-446e-bf5c-d8dcf971f4af":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Error message (alternative field)","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"48ef4edf-0ed2-415e-8599-82272ff5cabd":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Each key carries scopes chosen when it is created: `candidates:read`, `candidates:write`, `assessments:read`, `assessments:write`, `problems:read`, `problems:write`, `results:read`. Keys created before scopes existed have full access. A request with a key that lacks an operation's scope returns 403 naming the missing scope.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"ce60098d-e033-4f14-a9ee-e2533a87f962":{"url":"https://api.ropes.ai","description":"Production server"},"e9ca913f-fa71-402f-b3ac-efc6d99ebcb6":{"url":"http://localhost:3001","description":"Local development server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Each key carries scopes chosen when it is created: `candidates:read`, `candidates:write`, `assessments:read`, `assessments:write`, `problems:read`, `problems:write`, `results:read`. Keys created before scopes existed have full access. A request with a key that lacks an operation's scope returns 403 naming the missing scope.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Each key carries scopes chosen when it is created: `candidates:read`, `candidates:write`, `assessments:read`, `assessments:write`, `problems:read`, `problems:write`, `results:read`. Keys created before scopes existed have full access. A request with a key that lacks an operation's scope returns 403 naming the missing scope.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.ropes.ai/api/docs/openapi.json"},"subdomain":"ropes","siteName":"Ropes Docs","title":"Get Candidate by Email - Ropes Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T18:50:07.641Z","originalFileLocation":"api-reference/candidates/get-candidate-by-email.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=\"Get details for a specific candidate by email, including associated interview IDs Required scope: candidates:read\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ropes Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_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/ropes/NPoKpsg8yilE348a/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Candidate by Email - Ropes Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get details for a specific candidate by email, including associated interview IDs Required scope: candidates:read\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ropes Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ropes.mintlify.site/_mintlify/api/og/v2?division=Candidates\u0026amp;title=Get+Candidate+by+Email\u0026amp;description=Get+details+for+a+specific+candidate+by+email%2C+including+associated+interview+IDs%0A%0A**Required+scope%3A**+%60candidates%3Aread%60\u0026amp;theme=9c405234dc97ec46ca345420\u0026amp;signature=5a34aec1b1744e558f66c4598b41b76e76eeff154e7f47337a8699aad6932a29\">\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=\"Get Candidate by Email - Ropes Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get details for a specific candidate by email, including associated interview IDs Required scope: candidates:read\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ropes.mintlify.site/_mintlify/api/og/v2?division=Candidates\u0026amp;title=Get+Candidate+by+Email\u0026amp;description=Get+details+for+a+specific+candidate+by+email%2C+including+associated+interview+IDs%0A%0A**Required+scope%3A**+%60candidates%3Aread%60\u0026amp;theme=9c405234dc97ec46ca345420\u0026amp;signature=5a34aec1b1744e558f66c4598b41b76e76eeff154e7f47337a8699aad6932a29\">\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/ropes/NPoKpsg8yilE348a/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ropes Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/candidates/get-candidate-by-email.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ropes.ai/#organization\",\"name\":\"Ropes Docs\",\"url\":\"https://docs.ropes.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ropes/yLckSC5FeL4Ln3H7/logo/ropes_logo.svg?fit=max\u0026auto=format\u0026n=yLckSC5FeL4Ln3H7\u0026q=85\u0026s=d2e2621b500af139561039d3a77b2183\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ropes.ai#website\",\"name\":\"Ropes Docs\",\"url\":\"https://docs.ropes.ai\",\"publisher\":{\"@id\":\"https://docs.ropes.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email#webpage\",\"url\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email\",\"name\":\"Get Candidate by Email\",\"description\":\"Get details for a specific candidate by email, including associated interview IDs Required scope: candidates:read\",\"dateModified\":\"2026-10-22T18:50:07.641Z\",\"isPartOf\":{\"@id\":\"https://docs.ropes.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.ropes.ai/api-reference/candidates/get-candidates\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Candidates\",\"item\":\"https://docs.ropes.ai/api-reference/candidates/get-candidates\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Candidate by Email\",\"item\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email#apireference\",\"headline\":\"Get Candidate by Email\",\"name\":\"Get Candidate by Email\",\"description\":\"Get details for a specific candidate by email, including associated interview IDs Required scope: candidates:read\",\"url\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ropes.ai/api-reference/candidates/get-candidate-by-email#webpage\"},\"dateModified\":\"2026-10-22T18:50:07.641Z\",\"publisher\":{\"@id\":\"https://docs.ropes.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ropes.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ropes Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ropes Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Endpoints","pages":[{"group":"Candidates","pages":[{"title":"Get Candidates","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates","href":"/api-reference/candidates/get-candidates"},{"title":"Create Candidate","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json post /api/public/candidates","href":"/api-reference/candidates/create-candidate"},{"title":"Get Candidate","description":"Get details for a specific candidate by candidate ID, including associated interview IDs.\n\n**Required scope:** `candidates:read`","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates/{candidateId}","href":"/api-reference/candidates/get-candidate"},{"title":"Get Candidate by Email","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates/email/{email}","href":"/api-reference/candidates/get-candidate-by-email"},{"title":"Report Candidate IP Telemetry","description":"Report an IP address your own systems observed for a candidate. Ropes stores the reading, enriches it with geolocation and network-concealment intelligence (VPN, proxy, Tor, relay, hosting), and plots it on the candidate's Trust Center as an external source alongside the locations Ropes observed itself. Returns 202 as soon as the reading is stored; enrichment completes asynchronously, so a reading appears on the Trust Center shortly after this call rather than immediately. Reposting an identical (ipAddress, observedAt) pair for the same candidate is a no-op and returns duplicate: true, so retries are safe. The address must be publicly routable — a private, loopback, or link-local address means your system reported an internal IP rather than the public egress address, and is rejected.\n\n**Required scope:** `candidates:write`","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json post /api/public/candidates/{candidateId}/ip-telemetry","href":"/api-reference/candidates/report-candidate-ip-telemetry"}]},{"group":"Scout","pages":[{"title":"Get Scout Result","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/candidates/{candidateId}/scout","href":"/api-reference/scout/get-scout-result"},{"title":"Trigger Scout Run","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json post /api/public/candidates/{candidateId}/scout","href":"/api-reference/scout/trigger-scout-run"}]},{"group":"Screens","pages":[{"title":"Get Screens","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/assessments","href":"/api-reference/screens/get-screens"},{"title":"Issue Screen","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json post /api/public/assessments","href":"/api-reference/screens/issue-screen"},{"title":"Get Screen","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/assessments/{interviewId}","href":"/api-reference/screens/get-screen"},{"title":"Get Screens for Candidate","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/assessments/candidate/{candidateId}","href":"/api-reference/screens/get-screens-for-candidate"}]},{"group":"Problems","pages":[{"title":"Get Problems","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems","href":"/api-reference/problems/get-problems"},{"title":"Create Problem","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json post /api/public/problems","href":"/api-reference/problems/create-problem"},{"title":"Search Problems","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems/search","href":"/api-reference/problems/search-problems"},{"title":"Get Problem","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems/{problemId}","href":"/api-reference/problems/get-problem"},{"title":"Update Problem","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json patch /api/public/problems/{problemId}","href":"/api-reference/problems/update-problem"},{"title":"Get Problem Status","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems/{problemId}/status","href":"/api-reference/problems/get-problem-status"},{"title":"Get Problem PDF","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems/{problemId}/pdf","href":"/api-reference/problems/get-problem-pdf"},{"title":"Get Problem Share Link","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/problems/{problemId}/shared","href":"/api-reference/problems/get-problem-share-link"}]},{"group":"Results","pages":[{"title":"Get Results","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/results/{interviewId}","href":"/api-reference/results/get-results"},{"title":"Get Results PDF","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/results/{interviewId}/pdf","href":"/api-reference/results/get-results-pdf"},{"title":"Get Shareable Results Link","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/results/{interviewId}/shared","href":"/api-reference/results/get-shareable-results-link"},{"title":"Get All Scores","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/results/scores","href":"/api-reference/results/get-all-scores"}]},{"group":"Usage","pages":[{"title":"Get Daily Usage Data","deprecated":null,"version":null,"openapi":"https://api.ropes.ai/api/docs/openapi.json get /api/public/usage","href":"/api-reference/usage/get-daily-usage-data"}]}]}]}]},"basePath":"","title":"Get Candidate by Email - Ropes Docs","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}