{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Outhire","colors":{"primary":"#C8A3FF","light":"#D4B5FF","dark":"#9B6FE8"},"logo":{"light":"https://mintcdn.com/outhireptyltd/yQ1SUzOoEV2GtJeo/logo/light.svg?fit=max\u0026auto=format\u0026n=yQ1SUzOoEV2GtJeo\u0026q=85\u0026s=92fddfbd5242ad0ae17f2cc65d91d45e","dark":"https://mintcdn.com/outhireptyltd/yQ1SUzOoEV2GtJeo/logo/dark.svg?fit=max\u0026auto=format\u0026n=yQ1SUzOoEV2GtJeo\u0026q=85\u0026s=d1a50252d883d386b36f1236d50f9030"},"favicon":"/favicon.svg","background":{},"navbar":{"links":[{"href":"mailto:support@outhire.ai","label":"Support"}],"primary":{"type":"button","label":"Get Started","href":"https://outhire.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/outhire-ai"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"outhireptyltd","hasAudioNarration":false,"actualSubdomain":"outhireptyltd","customDomains":["docs.outhire.ai"],"gitSource":{"type":"github","owner":"outhireai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21db43a5fe930653fbc02d","collectionId":"40073139-ad89-4f7e-bacd-37317aa2b6d0","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21db43a5fe930653fbc02d:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"Candidates","count":6},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Webhooks","count":3},{"language":"default","tag":"Getting started","count":2},{"language":"default","tag":"Jobs","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@outhire.ai","showHelpButton":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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/candidates/get-candidate","slug":"/api-reference/candidates/get-candidate","pageMetadata":{"title":"Get candidate","description":"Returns a single candidate if it belongs to the authenticated company.","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/candidates/{id}","href":"/api-reference/candidates/get-candidate","autogeneratedByOpenApi":true,"hidden":false},"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: \"Returns a single candidate if it belongs to the authenticated company.\"\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","description":"Returns a single candidate if it belongs to the authenticated company.","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/candidates/{id}","href":"/api-reference/candidates/get-candidate","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Candidates"],"summary":"Get candidate","description":"Returns a single candidate if it belongs to the authenticated company.","parameters":["c1c0933a-14db-438b-a2c2-a3e7cc323cad"],"responses":{"200":"8a43a900-d898-4bee-b487-188f41ce4f43","400":"862a10d8-0533-4c91-bacb-22a50b6d11ce","401":"d0b46967-1108-4643-acec-4a0bfa01e1a7","404":"fe8257b6-e131-466d-8c42-ac31cea603ad","500":"e3eba3a7-01d8-4b2f-8a23-bd33967d960d"},"method":"get","type":"path","servers":["c94791d7-3194-49ad-a70b-b9df522d763a"],"security":["54654f1f-6ad3-4a47-b9d5-e50e45757ca5"],"path":"/api/v1/candidates/{id}","baseUrlOptions":["https://app.outhire.ai"],"title":"Get candidate","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c1c0933a-14db-438b-a2c2-a3e7cc323cad":{"name":"id","in":"path","required":true,"description":"Numeric candidate id.","schema":{"type":"integer","isRequired":true,"description":"Numeric candidate id.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"8a43a900-d898-4bee-b487-188f41ce4f43":{"description":"Candidate","content":{"application/json":{"schema":{"description":"Wrapper for a single candidate resource.","type":"object","required":["data"],"properties":{"data":{"description":"Public representation of a candidate.","type":"object","required":["id","public_id","name","email","phone","linkedin","location","stage","rating","fit_score","application_source","ats_candidate_id","job","created_at","updated_at"],"properties":{"id":{"type":"integer","description":"Internal numeric candidate id.","example":419,"isRequired":true,"uniqueKey":"data.id","typeLabel":"integer"},"public_id":{"type":"string","description":"Public UUID-like candidate identifier.","example":"e3745169-a137-4b99-8fcc-373d6d4c8d60","isRequired":true,"uniqueKey":"data.public_id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Candidate name.","example":"Jane Doe","isRequired":true,"uniqueKey":"data.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Candidate name.","example":"Jane Doe","isRequired":true,"uniqueKey":"data.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","format":"email","description":"Candidate email.","example":"jane@example.com","isRequired":true,"uniqueKey":"data.email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Candidate email.","example":"jane@example.com","isRequired":true,"uniqueKey":"data.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.email","typeLabel":"string\u003cemail> | null"},"phone":{"oneOf":[{"type":"string","description":"Candidate phone number after normalization where possible.","example":"+61412345678","isRequired":true,"uniqueKey":"data.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Candidate phone number after normalization where possible.","example":"+61412345678","isRequired":true,"uniqueKey":"data.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.phone","typeLabel":"string | null"},"linkedin":{"oneOf":[{"type":"string","format":"uri","description":"LinkedIn profile URL.","example":"https://linkedin.com/in/janedoe","isRequired":true,"uniqueKey":"data.linkedin.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"LinkedIn profile URL.","example":"https://linkedin.com/in/janedoe","isRequired":true,"uniqueKey":"data.linkedin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.linkedin","typeLabel":"string\u003curi> | null"},"location":{"oneOf":[{"type":"string","description":"Candidate location string.","example":"Sydney, Australia","isRequired":true,"uniqueKey":"data.location.oneOf.0","typeLabel":"string"},{"type":"null","description":"Candidate location string.","example":"Sydney, Australia","isRequired":true,"uniqueKey":"data.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.location","typeLabel":"string | null"},"stage":{"oneOf":[{"type":"string","description":"Current candidate stage.","example":"applied","isRequired":true,"uniqueKey":"data.stage.oneOf.0","typeLabel":"string"},{"type":"null","description":"Current candidate stage.","example":"applied","isRequired":true,"uniqueKey":"data.stage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.stage","typeLabel":"string | null"},"rating":{"oneOf":[{"type":"integer","minimum":1,"maximum":5,"description":"Candidate rating if set.","example":4,"isRequired":true,"uniqueKey":"data.rating.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":5,"description":"Candidate rating if set.","example":4,"isRequired":true,"uniqueKey":"data.rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.rating","typeLabel":"integer | null"},"fit_score":{"oneOf":[{"type":"number","description":"Candidate fit score if present.","example":82,"isRequired":true,"uniqueKey":"data.fit_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Candidate fit score if present.","example":82,"isRequired":true,"uniqueKey":"data.fit_score.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.fit_score","typeLabel":"number | null"},"application_source":{"description":"Candidate application source value set by this API.","type":"string","enum":["public_api"],"isRequired":true,"uniqueKey":"data.application_source","typeLabel":"enum\u003cstring>"},"ats_candidate_id":{"oneOf":[{"type":"string","description":"Optional external ATS identifier.","example":"ext-456","isRequired":true,"uniqueKey":"data.ats_candidate_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional external ATS identifier.","example":"ext-456","isRequired":true,"uniqueKey":"data.ats_candidate_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.ats_candidate_id","typeLabel":"string | null"},"job":{"oneOf":[{"type":"null","description":"The job associated with the candidate.","isRequired":true,"uniqueKey":"data.job.oneOf.0","typeLabel":"null"},{"type":"object","description":"The job associated with the candidate.","required":["id","title"],"properties":{"id":{"oneOf":[{"type":"integer","description":"Internal numeric job id.","example":40,"isRequired":true,"uniqueKey":"data.job.oneOf.1.id.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Internal numeric job id.","example":40,"isRequired":true,"uniqueKey":"data.job.oneOf.1.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.job.oneOf.1.id","typeLabel":"integer | null"},"title":{"oneOf":[{"type":"string","description":"Job title.","example":"Senior Engineer","isRequired":true,"uniqueKey":"data.job.oneOf.1.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job title.","example":"Senior Engineer","isRequired":true,"uniqueKey":"data.job.oneOf.1.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.job.oneOf.1.title","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.job.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.job","typeLabel":"null | object"},"created_at":{"type":"string","format":"date-time","description":"Candidate creation timestamp.","example":"2026-03-11T10:21:54.289003Z","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"Candidate last update timestamp.","example":"2026-03-11T10:21:54.544000Z","isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"},"applied_at":{"type":"string","format":"date-time","description":"Present on detailed candidate responses. Mirrors the candidate creation timestamp.","example":"2026-03-11T10:21:54.289003Z","uniqueKey":"data.applied_at","typeLabel":"string\u003cdate-time>"},"resume_url":{"oneOf":[{"type":"string","format":"uri","description":"Present on detailed candidate responses when a resume file exists. Signed URL expires.","example":"https://api.outhire.ai/storage/cv/example.pdf?token=eyJhbGciOiJIUzI1NiIs...","uniqueKey":"data.resume_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Present on detailed candidate responses when a resume file exists. Signed URL expires.","example":"https://api.outhire.ai/storage/cv/example.pdf?token=eyJhbGciOiJIUzI1NiIs...","uniqueKey":"data.resume_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.resume_url","typeLabel":"string\u003curi> | null"},"resume_data":{"oneOf":[{"type":"null","description":"Present on detailed candidate responses after async resume extraction completes.","uniqueKey":"data.resume_data.oneOf.0","typeLabel":"null"},{"type":"object","description":"Present on detailed candidate responses after async resume extraction completes.","additionalProperties":true,"uniqueKey":"data.resume_data.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.resume_data","typeLabel":"null | object"},"resume_status":{"oneOf":[{"type":"string","description":"Present on detailed candidate responses when resume processing is relevant.","example":"processed","uniqueKey":"data.resume_status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Present on detailed candidate responses when resume processing is relevant.","example":"processed","uniqueKey":"data.resume_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.resume_status","typeLabel":"string | null"}},"example":{"id":419,"public_id":"e3745169-a137-4b99-8fcc-373d6d4c8d60","name":"Jane Doe","email":"jane@example.com","phone":"+61412345678","linkedin":"https://linkedin.com/in/janedoe","location":"Sydney, Australia","stage":"applied","rating":4,"fit_score":82,"application_source":"public_api","ats_candidate_id":"ext-456","job":{"id":40,"title":"Senior Engineer"},"created_at":"2026-03-11T10:21:54.289003Z","updated_at":"2026-03-11T10:21:54.544000Z","applied_at":"2026-03-11T10:21:54.289003Z","resume_url":"https://api.outhire.ai/storage/cv/example.pdf?token=eyJhbGciOiJIUzI1NiIs...","resume_data":{"personalInfo":{"name":"Jane Doe","email":"jane@example.com"},"summary":"Senior engineer with 8 years of experience"},"resume_status":"processed"},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":419,"public_id":"e3745169-a137-4b99-8fcc-373d6d4c8d60","name":"Jane Doe","email":"jane@example.com","phone":"+61412345678","linkedin":"https://linkedin.com/in/janedoe","location":"Sydney, Australia","stage":"applied","rating":4,"fit_score":82,"application_source":"public_api","ats_candidate_id":"ext-456","job":{"id":40,"title":"Senior Engineer"},"created_at":"2026-03-11T10:21:54.289003Z","updated_at":"2026-03-11T10:21:54.544000Z","applied_at":"2026-03-11T10:21:54.289003Z","resume_url":"https://api.outhire.ai/storage/cv/example.pdf?token=eyJhbGciOiJIUzI1NiIs...","resume_data":{"personalInfo":{"name":"Jane Doe","email":"jane@example.com"},"summary":"Senior engineer with 8 years of experience"},"resume_status":"processed"}}}},"exampleType":"generated"}},"exampleType":"generated"},"862a10d8-0533-4c91-bacb-22a50b6d11ce":{"description":"Bad request","content":{"application/json":{"schema":{"description":"Top-level API error response.","type":"object","required":["error"],"properties":{"error":{"description":"Standard error envelope payload.","type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["validation_error","bad_request","unauthorized","not_found","conflict","unprocessable_entity","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable description of the error.","example":"Request validation failed.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Optional field-level validation details.","items":{"description":"Validation detail for a specific request field.","type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Request field path that failed validation.","example":"email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable validation message.","example":"Invalid email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"d0b46967-1108-4643-acec-4a0bfa01e1a7":{"description":"Unauthorized","content":{"application/json":{"schema":{"description":"Top-level API error response.","type":"object","required":["error"],"properties":{"error":{"description":"Standard error envelope payload.","type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["validation_error","bad_request","unauthorized","not_found","conflict","unprocessable_entity","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable description of the error.","example":"Request validation failed.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Optional field-level validation details.","items":{"description":"Validation detail for a specific request field.","type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Request field path that failed validation.","example":"email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable validation message.","example":"Invalid email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Missing or invalid API key."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Missing or invalid API key."}}}},"exampleType":"examples"}},"exampleType":"examples"},"fe8257b6-e131-466d-8c42-ac31cea603ad":{"description":"Resource not found","content":{"application/json":{"schema":{"description":"Top-level API error response.","type":"object","required":["error"],"properties":{"error":{"description":"Standard error envelope payload.","type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["validation_error","bad_request","unauthorized","not_found","conflict","unprocessable_entity","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable description of the error.","example":"Request validation failed.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Optional field-level validation details.","items":{"description":"Validation detail for a specific request field.","type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Request field path that failed validation.","example":"email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable validation message.","example":"Invalid email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"e3eba3a7-01d8-4b2f-8a23-bd33967d960d":{"description":"Internal server error","content":{"application/json":{"schema":{"description":"Top-level API error response.","type":"object","required":["error"],"properties":{"error":{"description":"Standard error envelope payload.","type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["validation_error","bad_request","unauthorized","not_found","conflict","unprocessable_entity","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable description of the error.","example":"Request validation failed.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","description":"Optional field-level validation details.","items":{"description":"Validation detail for a specific request field.","type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Request field path that failed validation.","example":"email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Human-readable validation message.","example":"Invalid email","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"example":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"Request validation failed.","details":[{"field":"email","message":"Invalid email"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"54654f1f-6ad3-4a47-b9d5-e50e45757ca5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","scopes":[]}}},"servers":{"c94791d7-3194-49ad-a70b-b9df522d763a":{"url":"https://app.outhire.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"outhireptyltd","siteName":"Outhire","title":"Get candidate - Outhire","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-11T23:35:32.101Z","originalFileLocation":"api-reference/candidates/get-candidate.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=\"Returns a single candidate if it belongs to the authenticated company.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Outhire\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_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/outhireptyltd/p_jxAwHCcIveJDcZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get candidate - Outhire\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a single candidate if it belongs to the authenticated company.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Outhire\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.outhire.ai/api-reference/candidates/get-candidate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://outhireptyltd.mintlify.app/_mintlify/api/og/v2?division=Candidates\u0026amp;title=Get+candidate\u0026amp;description=Returns+a+single+candidate+if+it+belongs+to+the+authenticated+company.\u0026amp;theme=090ff011f63c74fa928a10fe\u0026amp;signature=79d609bafa5112650f31d46e5e8c0f2b01919e2e7f2b2c3495e6670085e69809\">\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 - Outhire\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a single candidate if it belongs to the authenticated company.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://outhireptyltd.mintlify.app/_mintlify/api/og/v2?division=Candidates\u0026amp;title=Get+candidate\u0026amp;description=Returns+a+single+candidate+if+it+belongs+to+the+authenticated+company.\u0026amp;theme=090ff011f63c74fa928a10fe\u0026amp;signature=79d609bafa5112650f31d46e5e8c0f2b01919e2e7f2b2c3495e6670085e69809\">\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/outhireptyltd/p_jxAwHCcIveJDcZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Outhire\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8A3FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.outhire.ai/api-reference/candidates/get-candidate\">\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.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.outhire.ai/#organization\",\"name\":\"Outhire\",\"url\":\"https://docs.outhire.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/outhireptyltd/yQ1SUzOoEV2GtJeo/logo/light.svg?fit=max\u0026auto=format\u0026n=yQ1SUzOoEV2GtJeo\u0026q=85\u0026s=92fddfbd5242ad0ae17f2cc65d91d45e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.outhire.ai#website\",\"name\":\"Outhire\",\"url\":\"https://docs.outhire.ai\",\"publisher\":{\"@id\":\"https://docs.outhire.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate#webpage\",\"url\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate\",\"name\":\"Get candidate\",\"description\":\"Returns a single candidate if it belongs to the authenticated company.\",\"dateModified\":\"2026-03-11T23:35:32.101Z\",\"isPartOf\":{\"@id\":\"https://docs.outhire.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Candidates\",\"item\":\"https://docs.outhire.ai/api-reference/candidates/list-candidates\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get candidate\",\"item\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate#apireference\",\"headline\":\"Get candidate\",\"name\":\"Get candidate\",\"description\":\"Returns a single candidate if it belongs to the authenticated company.\",\"url\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.outhire.ai/api-reference/candidates/get-candidate#webpage\"},\"dateModified\":\"2026-03-11T23:35:32.101Z\",\"publisher\":{\"@id\":\"https://docs.outhire.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.outhire.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Outhire\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Outhire","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Bulk endpoints","href":"/api-reference/bulk-endpoints"},{"title":"API roadmap","href":"/api-reference/roadmap"}]},{"group":"Jobs","pages":[{"title":"List jobs","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Get job","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/jobs/{id}","href":"/api-reference/jobs/get-job"}]},{"group":"Candidates","pages":[{"title":"List candidates","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/candidates","href":"/api-reference/candidates/list-candidates"},{"title":"Create candidate","description":"Creates a candidate under a job owned by the authenticated company.\n\nSupports either:\n- `application/json` for metadata-only candidate creation\n- `multipart/form-data` when uploading a resume file\n\nWhen a resume is uploaded, it is processed asynchronously. The\n`resume_data` field may be `null` in the immediate response and will\npopulate once processing completes.\n","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml post /api/v1/candidates","href":"/api-reference/candidates/create-candidate"},{"title":"Get candidate","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/candidates/{id}","href":"/api-reference/candidates/get-candidate"},{"title":"Update candidate","description":"Updates an existing candidate for the authenticated company.\n\nAt least one updatable field must be present. Supplying `notes` creates a\n`note_added` activity. Supplying a new `stage` creates a `stage_changed`\nactivity and enqueues the `candidate.stage_changed` webhook event.\n","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml patch /api/v1/candidates/{id}","href":"/api-reference/candidates/update-candidate"},{"title":"List candidate notes","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml get /api/v1/candidates/{id}/notes","href":"/api-reference/candidates/list-candidate-notes"},{"title":"Create candidate note","deprecated":null,"version":null,"openapi":"api-reference/openapi.yaml post /api/v1/candidates/{id}/notes","href":"/api-reference/candidates/create-candidate-note"}]}]}]},"title":"Get candidate - Outhire","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-D5fEM6aW.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}