Due to EPFO restrictions, this API can only provide the candidate’s last
employment record. Full employment history is no longer available.
This API retrieves a candidate’s past employment details using a valid 10-digit Indian mobile number. When you supply the mobile number, the API fetches basic personal information—such as full name, gender, and date of birth—and returns a list of previous employers, including details like joining and exit dates, employer names, and identification numbers. Essentially, it streamlines the process of obtaining verified work history data, which can be useful for background checks and employment verification purposes.
You will be charged for API calls regardless of the response, including both
200 (successful) and 404 (not found) status codes.
Represents the remaining credits available for use.
Example:
4040
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"KonnectNXT","colors":{"primary":"#005eff","light":"#005eff","dark":"#005eff"},"favicon":"https://mintcdn.com/konnectnxt-599b559e/VLKjQdtWPUg5a3yC/favicon.svg?fit=max\u0026auto=format\u0026n=VLKjQdtWPUg5a3yC\u0026q=85\u0026s=997af184ab83582a14443eec928e2736","logo":{"light":"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/light.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=2698d3d46a93990f38aa74081cd25a57","dark":"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/dark.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=d31b61f5c4c846883596cd4139d42c1b"},"api":{"mdx":{"server":"https://bgv.konnectnxt.com/api","auth":{"method":"bearer","name":null}}},"navbar":{"links":[{"label":"Support","href":"mailto:support@konnectnxt.com"}],"primary":{"type":"button","label":"Request Demo","href":"https://konnectnxt.com/contact-us"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/konnectnxt","website":"http://konnectnct.com"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Terms \u0026 Conditions","href":"https://konnectnxt.com/terms-and-conditions","icon":{"name":"file","style":"light"}},{"anchor":"Privacy Policy","href":"https://konnectnxt.com/privacy-policy","icon":{"name":"lock","style":"light"}}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"konnectnxt-599b559e","hasAudioNarration":false,"actualSubdomain":"konnectnxt-599b559e","customDomains":["docs.konnectnxt.com"],"gitSource":{"type":"github","owner":"j471n","repo":"knxt-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6ae9237aebe6959d239e3f85:success","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":38},{"language":"default","tag":"Background Verification","count":17},{"language":"default","tag":"Identity Verification","count":7},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Business Verification","count":4},{"language":"default","tag":"OCR APIs","count":4},{"language":"default","tag":"BGV Submit V2","count":3},{"language":"default","tag":"GST Verification","count":3},{"language":"default","tag":"Employment","count":3},{"language":"default","tag":"Financial APIs","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/employment/employment-history","slug":"/api-reference/employment/employment-history","pageMetadata":{"title":"Employment History","openapi":"GET /verification/get-employment-history","description":"Fetches previous employment history using the candidate's mobile number.","href":"/api-reference/employment/employment-history"},"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: \"Fetches previous employment history using the candidate’s mobile number.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`Due to EPFO restrictions, this API can only provide the candidate’s `,_jsx(_components.strong,{children:`last\nemployment record`}),`. Full employment history is no longer available.`]})}),`\n`,_jsxs(_components.p,{children:[`This API retrieves a candidate’s past employment details using a valid `,_jsx(_components.strong,{children:`10-digit Indian mobile number`}),`. When you supply the mobile number, the API fetches basic personal information—such as full name, gender, and date of birth—and returns a list of previous employers, including details like joining and exit dates, employer names, and identification numbers. Essentially, it streamlines the process of obtaining verified work history data, which can be useful for background checks and employment verification purposes.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`You will be charged for API calls regardless of the response, including both\n`,_jsx(_components.code,{children:`200`}),` (successful) and `,_jsx(_components.code,{children:`404`}),` (not found) status codes.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Employment History","openapi":"GET /verification/get-employment-history","description":"Fetches previous employment history using the candidate's mobile number.","href":"/api-reference/employment/employment-history"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Fetches previous employment history using the candidate's mobile number.","operationId":"verification_get_employment_history","tags":["Employment Verification"],"parameters":["acc33b93-aa56-4a8b-a8a2-7d6d5917e39b"],"responses":{"200":"a7cb4652-eed2-44de-9737-6691699978a7","400":"75fd07ad-265c-4b01-bb2d-043ecd9c3905","401":"fe4783ca-2893-401b-a61d-2dcb18c558eb","402":"1dba77fe-9778-4663-8eaa-cdb87848bd37","403":"40c535a3-ba9d-4d0f-a22d-0ce1e533fefe","404":"144ffa74-f474-42ee-a7ed-7c8ad2098f80","500":"add102bf-3c95-4846-968f-4f8aa7760bc0"},"method":"get","type":"path","servers":["0f4398fb-151c-4843-bf1d-e8ec85190589","d0880660-8419-4297-855a-15a6f3f6b477"],"security":["7e290d57-06ef-429a-a878-7d3fcc230981"],"path":"/verification/get-employment-history","baseUrlOptions":["https://bgv.konnectnxt.com/api","https://testbgv.konnectnxt.com/api"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"acc33b93-aa56-4a8b-a8a2-7d6d5917e39b":{"name":"mobile","in":"query","required":true,"schema":{"type":"string","pattern":"^[6-9]\\d{9}$","example":"9990191919","isRequired":true,"description":"The 10-digit Indian mobile number of the candidate.","uniqueKey":"","typeLabel":"string"},"description":"The 10-digit Indian mobile number of the candidate."}},"responses":{"a7cb4652-eed2-44de-9737-6691699978a7":{"description":"Successful response with employment history details.","content":{"application/json":{"schema":{"type":"object","required":["credits_used","credits_left","data","status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","required":["case_id","personal_details","employment_history"],"properties":{"case_id":{"required":["case_id"],"type":"string","description":"Unique Case Id for BGV","isRequired":true,"uniqueKey":"data.case_id","typeLabel":"string"},"personal_details":{"type":"object","description":"Basic personal details of the candidate","properties":{"user_gender":{"type":"string","enum":["MALE","FEMALE","OTHER"],"isRequired":true,"uniqueKey":"data.personal_details.user_gender","typeLabel":"enum\u003cstring>"},"user_dob":{"type":"string","format":"date","description":"Date format: DD-MM-YYYY","example":"23-08-1999","isRequired":true,"uniqueKey":"data.personal_details.user_dob","typeLabel":"string\u003cdate>"},"user_full_name":{"type":"string","isRequired":true,"uniqueKey":"data.personal_details.user_full_name","typeLabel":"string"},"user_phone_number":{"type":"string","description":"10-digit mobile number","isRequired":true,"uniqueKey":"data.personal_details.user_phone_number","typeLabel":"string"}},"required":["user_gender","user_dob","user_full_name","user_phone_number"],"isRequired":true,"uniqueKey":"data.personal_details","typeLabel":"object"},"employment_history":{"type":"array","description":"List of previous employers.","items":{"type":"object","properties":{"sequence_number":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].sequence_number","typeLabel":"string"},"uan_number":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].uan_number","typeLabel":"string"},"date_of_exit":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].date_of_exit","typeLabel":"string"},"date_of_joining":{"type":"string","description":"Date format: DD-MM-YYYY","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].date_of_joining","typeLabel":"string"},"establishment_id":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].establishment_id","typeLabel":"string"},"establishment_name":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].establishment_name","typeLabel":"string"},"member_id":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].member_id","typeLabel":"string"},"exit_reason":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].exit_reason","typeLabel":"string"},"mobile":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].mobile","typeLabel":"string"},"aadhaar_verification_status":{"type":"string","isRequired":true,"uniqueKey":"data.employment_history.items.[INDEX].aadhaar_verification_status","typeLabel":"string"}},"required":["sequence_number","uan_number","date_of_exit","date_of_joining","establishment_id","establishment_name","member_id","exit_reason","mobile","aadhaar_verification_status"],"uniqueKey":"data.employment_history.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.employment_history","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"credits_used":{"type":"integer","description":"Represents the total number of credits used in this request.","example":3,"isRequired":true,"uniqueKey":"credits_used","typeLabel":"integer"},"credits_left":{"type":"integer","description":"Represents the remaining credits available for use. ","example":4040,"isRequired":true,"uniqueKey":"credits_left","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Success":{"title":"Success","value":{"status":"success","code":200,"message":"Data Fetched Successfully.","data":{"case_id":"8a3b2d79e91c4ff1b2e97b9f2b36c123","personal_details":{"user_gender":"MALE","user_dob":"23-08-1999","user_full_name":"John Doe","user_phone_number":"9101010101"},"employment_history":[{"sequence_number":"1","uan_number":"100342762111","date_of_exit":"NA","date_of_joining":"30-03-2015","establishment_id":"PYKRP00139620000023393","establishment_name":"ABC Pvt Ltd","member_id":"PBK0012345678","exit_reason":"NA","mobile":"NA","aadhaar_verification_status":""}]},"credits_used":1,"credits_remaining":499}}},"exampleType":"examples"}},"exampleType":"examples"},"75fd07ad-265c-4b01-bb2d-043ecd9c3905":{"description":"Bad request due to invalid or missing mobile number.","content":{"application/json":{"examples":{"Missing Mobile":{"title":"Missing Mobile","value":{"status":"error","code":400,"message":"`mobile` is required.","data":null,"credits_used":0,"credits_remaining":8858}},"Blank Mobile":{"title":"Blank Mobile","value":{"status":"error","code":400,"message":"`mobile` can't be blank","data":null,"credits_used":0,"credits_remaining":8858}},"Invalid Mobile":{"title":"Invalid Mobile","value":{"status":"error","code":400,"message":"Enter a valid 10-digit Indian mobile number.","data":null,"credits_used":0,"credits_remaining":8858}}},"exampleType":"examples"}},"exampleType":"examples"},"fe4783ca-2893-401b-a61d-2dcb18c558eb":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Missing Token":{"title":"Missing Token","value":{"status":"error","code":401,"message":"Bearer token is missing or invalid.","data":null}},"Incorrect Token Format":{"title":"Incorrect Token Format","value":{"status":"error","code":401,"message":"Token format is incorrect","data":null}},"No Admin Found":{"title":"No Admin Found","value":{"status":"error","code":401,"message":"No admin user found for this organization","data":null}},"Invalid API Key":{"title":"Invalid API Key","value":{"status":"error","code":401,"message":"Invalid API key (organization ID)","data":null}},"User not Found":{"title":"User not Found","value":{"status":"error","code":401,"message":"User not found.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"1dba77fe-9778-4663-8eaa-cdb87848bd37":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Credit Limit Exceed":{"title":"Credit Limit Exceed","value":{"status":"error","code":402,"message":"Credit Limit Exceeded.","data":null}},"Insufficient Credits":{"title":"Insufficient Credits","value":{"status":"error","code":402,"message":"Insufficient credits: 2 required, 1 remaining.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"40c535a3-ba9d-4d0f-a22d-0ce1e533fefe":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Token Revoked":{"title":"Token Revoked","value":{"status":"error","code":403,"message":"Token access has been Revoked, Contact Support.","data":null}},"Token Inactive":{"title":"Token Inactive","value":{"status":"error","code":403,"message":"Token is Inactive, Contact Support.","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"144ffa74-f474-42ee-a7ed-7c8ad2098f80":{"description":"No Records Found","content":{"application/json":{"schema":{"type":"object","required":["credits_used","credits_left","data","status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","required":["case_id"],"properties":{"case_id":{"required":["case_id"],"type":"string","description":"Unique Case Id for BGV","isRequired":true,"uniqueKey":"data.case_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"credits_used":{"type":"integer","description":"Represents the total number of credits used in this request.","example":3,"isRequired":true,"uniqueKey":"credits_used","typeLabel":"integer"},"credits_left":{"type":"integer","description":"Represents the remaining credits available for use. ","example":4040,"isRequired":true,"uniqueKey":"credits_left","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"No records found":{"title":"No records found","value":{"status":"error","code":404,"message":"No records found.","data":{"case_id":"8a3b2d79e91c4ff1b2e97b9f2b36c123"},"credits_used":2,"credits_remaining":499}}},"exampleType":"examples"}},"exampleType":"examples"},"add102bf-3c95-4846-968f-4f8aa7760bc0":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","required":["credits_used","credits_left","status","code","message"],"properties":{"status":{"type":"string","enum":["success","error"],"description":"Overall status of the API","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Description of the response or error","example":"Invalid request parameters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"credits_used":{"type":"integer","description":"Represents the total number of credits used in this request.","example":3,"isRequired":true,"uniqueKey":"credits_used","typeLabel":"integer"},"credits_left":{"type":"integer","description":"Represents the remaining credits available for use. ","example":4040,"isRequired":true,"uniqueKey":"credits_left","typeLabel":"integer"},"data":{"oneOf":[{"type":"object","example":null,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","example":null,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Internal Server Error":{"title":"Internal Server Error","value":{"status":"error","code":500,"message":"Internal Server Error.","data":null,"credits_used":3,"credits_remaining":178}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"7e290d57-06ef-429a-a878-7d3fcc230981":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","scopes":[]}}},"servers":{"0f4398fb-151c-4843-bf1d-e8ec85190589":{"url":"https://bgv.konnectnxt.com/api","description":"Production"},"d0880660-8419-4297-855a-15a6f3f6b477":{"url":"https://testbgv.konnectnxt.com/api","description":"QA"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key issued by KonnectNXT. Pass as `Authorization: Bearer \u003cyour_api_key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"konnectnxt-599b559e","siteName":"KonnectNXT","title":"Employment History - KonnectNXT","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-04T13:40:07.251Z","originalFileLocation":"api-reference/employment/employment-history.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=\"Fetches previous employment history using the candidate\u0026#x27;s mobile number.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KonnectNXT\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_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/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Employment History - KonnectNXT\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetches previous employment history using the candidate\u0026#x27;s mobile number.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KonnectNXT\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.konnectnxt.com/api-reference/employment/employment-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://konnectnxt-599b559e.mintlify.site/_mintlify/api/og/v2?division=Employment\u0026amp;title=Employment+History\u0026amp;description=Fetches+previous+employment+history+using+the+candidate%27s+mobile+number.\u0026amp;theme=7cc3ec472db4b3c9e2a39a5f\u0026amp;signature=dcf0eb09cd2eeeb3d4e96c1fab48467040ce76b1505d874c14f95b03becc35b8\">\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=\"Employment History - KonnectNXT\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetches previous employment history using the candidate\u0026#x27;s mobile number.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://konnectnxt-599b559e.mintlify.site/_mintlify/api/og/v2?division=Employment\u0026amp;title=Employment+History\u0026amp;description=Fetches+previous+employment+history+using+the+candidate%27s+mobile+number.\u0026amp;theme=7cc3ec472db4b3c9e2a39a5f\u0026amp;signature=dcf0eb09cd2eeeb3d4e96c1fab48467040ce76b1505d874c14f95b03becc35b8\">\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/konnectnxt-599b559e/rUd15rnLwvETE97R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KonnectNXT\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#005eff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.konnectnxt.com/api-reference/employment/employment-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/employment/employment-history.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.konnectnxt.com/#organization\",\"name\":\"KonnectNXT\",\"url\":\"https://docs.konnectnxt.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/konnectnxt-599b559e/cyfEQxBdIVhYMC5i/logo/light.png?fit=max\u0026auto=format\u0026n=cyfEQxBdIVhYMC5i\u0026q=85\u0026s=2698d3d46a93990f38aa74081cd25a57\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.konnectnxt.com#website\",\"name\":\"KonnectNXT\",\"url\":\"https://docs.konnectnxt.com\",\"publisher\":{\"@id\":\"https://docs.konnectnxt.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history#webpage\",\"url\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history\",\"name\":\"Employment History\",\"description\":\"Fetches previous employment history using the candidate's mobile number.\",\"dateModified\":\"2026-06-04T13:40:07.251Z\",\"isPartOf\":{\"@id\":\"https://docs.konnectnxt.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Background Verification\",\"item\":\"https://docs.konnectnxt.com/api-reference/bgv/bgv-submit-v2\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Employment History\",\"item\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history#apireference\",\"headline\":\"Employment History\",\"name\":\"Employment History\",\"description\":\"Fetches previous employment history using the candidate's mobile number.\",\"url\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.konnectnxt.com/api-reference/employment/employment-history#webpage\"},\"dateModified\":\"2026-06-04T13:40:07.251Z\",\"publisher\":{\"@id\":\"https://docs.konnectnxt.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.konnectnxt.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KonnectNXT\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"KonnectNXT\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/employment/employment-history.md","siteName":"KonnectNXT","nav":{"global":{"anchors":[{"anchor":"Terms \u0026 Conditions","href":"https://konnectnxt.com/terms-and-conditions","icon":{"name":"file","style":"light"}},{"anchor":"Privacy Policy","href":"https://konnectnxt.com/privacy-policy","icon":{"name":"lock","style":"light"}}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/product-docs/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Background Verification","pages":[{"group":"BGV Submit V2","pages":[{"title":"Submit Candidates for BGV (Bulk)","openapi":"POST /async/v2/bgv-submit/","href":"/api-reference/bgv/bgv-submit-v2"},{"title":"Download BGV Report","openapi":"GET /verification/bgv/download","href":"/api-reference/bgv/bgv-report-download"},{"title":"Fetch BGV Report (JSON)","openapi":"GET /recruiter/v2/report-json/","href":"/api-reference/bgv/bgv-report-json"}]},{"group":"DigiLocker","pages":[{"title":"Initiate DigiLocker","openapi":"POST /client/profile-creation-with-digilocker","href":"/api-reference/digilocker/initiate"},{"title":"Fetch DigiLocker Data","openapi":"GET /client/fetch-profile-data","href":"/api-reference/digilocker/retrieve-data"}]},{"group":"Crime Check","pages":[{"title":"Initiate Crime Check","openapi":"POST /v2/verification/crime-check/","href":"/api-reference/bgv/crime-check-initiate"},{"title":"Get Crime Report","openapi":"GET /v2/verification/crime-check/","href":"/api-reference/bgv/crime-check-report"}]},{"group":"Identity Verification","pages":[{"group":"Aadhaar","pages":[{"title":"Aadhaar Basic","openapi":"POST /verification/aadhaar-without-otp","href":"/api-reference/identity-verification/aadhaar/aadhaar-basic"}]},{"group":"PAN","pages":[{"title":"PAN Verification v2","openapi":"POST /v2/verification/pan","href":"/api-reference/identity-verification/pan/pan-verification-v2"},{"title":"Pan Basic","openapi":"POST /verification/pan-basic","href":"/api-reference/identity-verification/pan/pan-basic"},{"title":"PAN-Aadhaar Link","openapi":"POST /v2/verification/pan-aadhaar-link/","href":"/api-reference/identity-verification/pan/pan-aadhaar-link"}]},{"group":"Driving Licence","pages":[{"title":"Driving Licence Verification v2","openapi":"POST /v2/verification/driving-licence","href":"/api-reference/identity-verification/dl/driving-licence-v2"},{"title":"Driving Licence","openapi":"POST /verification/driving-licence","href":"/api-reference/identity-verification/dl/driving-licence"}]},{"group":"Passport","pages":[{"title":"Passport v2","openapi":"POST /v2/verification/passport/","description":"Verify Indian passport details using passport file number and date of birth","href":"/api-reference/identity-verification/passport/passport-verification-v2"}]}]},{"group":"Employment","pages":[{"title":"Employment History","openapi":"GET /verification/get-employment-history","href":"/api-reference/employment/employment-history"},{"group":"EPFO Verification","pages":[{"title":"EPFO Verification","openapi":"POST /v2/verification/epfo/","description":"Verifies EPFO employment details using UAN, PAN, or phone number","href":"/api-reference/employment/epfo-verification"},{"title":"Get Task Status","openapi":"GET /v2/tasks/","href":"/api-reference/employment/task_status"}]}]}]},{"group":"Lookup APIs","pages":[{"title":"Mobile to PAN","openapi":"GET /lookup/mobile-to-pan","href":"/api-reference/lookup/mobile-to-pan"}]},{"group":"Financial APIs","pages":[{"group":"Bank Account","pages":[{"title":"Bank Account v2","openapi":"POST /v2/verification/bank-account/","href":"/api-reference/financial/bank-account/advance-v2"},{"title":"Bank Account (Advance)","sidebarTitle":"Advance","openapi":"POST /verification/bank-verification-advance","href":"/api-reference/financial/bank-account/advance"}]},{"title":"Customer Financial Data Pull","sidebarTitle":"Customer Data Pull","openapi":"POST /v2/finance/customer-data-pull","href":"/api-reference/financial/customer-data-pull"}]},{"group":"Vehicle APIs","pages":[{"group":"Vehicle Details","pages":[{"title":"Vehicle Details","openapi":"POST /v2/verification/rc-book/","href":"/api-reference/vehicle/vehicle-details"}]}]},{"group":"OCR APIs","pages":[{"title":"Aadhaar v2","openapi":"POST /v2/ocr/aadhaar","href":"/api-reference/ocr/aadhaar-ocr"},{"title":"PAN v2","openapi":"POST /v2/ocr/pan","href":"/api-reference/ocr/pan-ocr"},{"title":"Indian Cheque v2","openapi":"POST /v2/ocr/cheque/","href":"/api-reference/ocr/cheque-ocr"},{"title":"GST Certificate v2","openapi":"POST /v2/ocr/gst-certificate/","href":"/api-reference/ocr/gst-certificate"}]},{"group":"Masking APIs","pages":[{"title":"Mask Aadhaar","openapi":"POST /v2/mask/aadhaar","href":"/api-reference/masking/aadhaar-masking"}]},{"group":"Validation","pages":[{"title":"Document Validation","openapi":"POST /v2/validate/document/","href":"/api-reference/validation/document-validation"}]},{"group":"Business Verification","pages":[{"title":"PAN-GST Link","openapi":"POST /v2/verification/pan-gst-link/","href":"/api-reference/business-verification/pan-gst-link"},{"group":"GST Verification","pages":[{"title":"GST Certificate v2","openapi":"POST /v2/verification/gst-certificate/","href":"/api-reference/business-verification/gst-verification/certificate"},{"title":"Initiate","openapi":"POST /gst/initiate","href":"/api-reference/business-verification/gst-verification/initiate"},{"title":"Status","openapi":"GET /gst/status","href":"/api-reference/business-verification/gst-verification/status"}]}]},{"group":"Document E-Sign","pages":[{"group":"E-Sign with Aadhaar","pages":[{"title":"E-Sign Generate API","openapi":"POST /esign/generate/","href":"/api-reference/e-Sign/generate"},{"title":"E-Sign Retrieve API","openapi":"POST /esign/retrieve/","href":"/api-reference/e-Sign/retrieve"}]}]},{"group":"Global DB","pages":[{"group":"Global DB check","pages":[{"title":"Global DB Initiate Check API","openapi":"POST /v2/verification/global-db/initiate/","href":"/api-reference/global-db/initiate"},{"title":"Global DB Result API","openapi":"GET /v2/verification/global-db/result/","href":"/api-reference/global-db/result"}]}]},{"group":"Credits","pages":[{"title":"Transaction Logs","openapi":"GET /v2/credits/transactions","href":"/api-reference/credits/transactions"}]}]}]},"basePath":"","title":"Employment History - KonnectNXT","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}