{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
Employees
Get an employee
Returns active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
{
"code": "not_found",
"detail": "No asset found for the given id.",
"instance": "/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f",
"requestId": "req_01HZY8Q3M4N5P6R7S8T9V0W1X2",
"status": 404,
"title": "Not Found",
"type": "https://api.secfix.com/problems/not_found"
}
Onboarding status, computed from the employee's tasks in this workspace the same way as on the People page in Secfix. NOT_APPLICABLE for a terminated employee or one with no applicable tasks. If the employee belongs to more than one workspace, the People page currently also counts tasks from the other workspaces, so the two can differ.
Onboarding progress by task category, and the employee's tasks.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Secfix Developers (Staging)","description":"Staging documentation for the Secfix Public API — includes the staging environment. For production docs, see developer.secfix.com.","colors":{"primary":"#762EEA","light":"#A47CF3","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/developer-staging-secfix/Q-9vTGgOSlO8yeFU/logo/light.svg?fit=max\u0026auto=format\u0026n=Q-9vTGgOSlO8yeFU\u0026q=85\u0026s=b6e2ca2f07e816208bdf37e60752ad07","dark":"https://mintcdn.com/developer-staging-secfix/Q-9vTGgOSlO8yeFU/logo/dark.svg?fit=max\u0026auto=format\u0026n=Q-9vTGgOSlO8yeFU\u0026q=85\u0026s=5c7e166ab0ada2db7f0f73e1b98e31d1"},"favicon":"https://mintcdn.com/developer-staging-secfix/wXpLA7sRWupSLgpu/favicon.svg?fit=max\u0026auto=format\u0026n=wXpLA7sRWupSLgpu\u0026q=85\u0026s=16e9bb91916a31f20ccae9e1dee085ec","navbar":{"links":[{"href":"mailto:support@secfix.com","label":"Support"}],"primary":{"type":"button","label":"Open Secfix","href":"https://app.secfix.com"}},"footer":{"socials":{"website":"https://secfix.com","linkedin":"https://www.linkedin.com/company/secfix"}},"banner":{"content":"🚧 Staging documentation — includes the staging environment. Production docs live at [developer.secfix.com](https://developer.secfix.com).","dismissible":true},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"envelope","href":"mailto:support@secfix.com"},{"anchor":"Secfix.com","icon":"globe","href":"https://secfix.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"developer-staging-secfix","hasAudioNarration":false,"actualSubdomain":"developer-staging-secfix","customDomains":["developer-staging.secfix.com"],"gitSource":{"type":"gitlab","owner":"secfix/core","repo":"secfix-developers-docs","deployBranch":"staging","contentDirectory":"staging","isPrivate":true,"projectId":81651564,"mountPath":"","label":"","_id":"6adb56a2fef607a661886cb7"},"entitlements":{},"buildId":"6aeb4c849649d32714d386ca","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API reference","count":18},{"language":"default","tag":"Endpoints","count":17},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Inventory","count":9},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Changelog","count":2},{"language":"default","tag":"Computers","count":2},{"language":"default","tag":"Employees","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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/employees/get-an-employee","slug":"/api-reference/employees/get-an-employee","pageMetadata":{"title":"Get an employee","description":"Returns active and terminated employees. An unknown `id`, an `id` from another workspace and a service account all return 404. Requires the `all:read` scope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/employees/{id}","href":"/api-reference/employees/get-an-employee","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns active and terminated employees. An unknown \", _jsx(_components.code, {\n children: \"id\"\n }), \", an \", _jsx(_components.code, {\n children: \"id\"\n }), \" from another workspace and a service account all return 404. Requires the \", _jsx(_components.code, {\n children: \"all:read\"\n }), \" scope.\"]\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 an employee","description":"Returns active and terminated employees. An unknown `id`, an `id` from another workspace and a service account all return 404. Requires the `all:read` scope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/employees/{id}","href":"/api-reference/employees/get-an-employee","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Employees"],"summary":"Get an employee","description":"Returns active and terminated employees. An unknown `id`, an `id` from another workspace and a service account all return 404. Requires the `all:read` scope.","operationId":"getEmployee","parameters":["ae307596-9273-4b98-ae7c-556537ac5a5f"],"responses":{"200":"cd923e76-8769-41ab-bcf1-4ecfd73736af","401":"5e5b44af-5d30-4762-ae5e-bedf5bbbecce","403":"d9298e48-45d0-4db5-a221-a0ecc7e9775a","404":"d4335180-dd88-454a-9c07-1b0af3bebfd5","405":"13f1e510-d266-4b79-adb2-ee28788a8649","429":"a03d4e0d-f758-47fd-8c99-506b8299d655","500":"97676f4e-1a2e-4492-ae89-7d6cdc07921f"},"method":"get","type":"path","servers":["4f2cec6e-2289-49a2-8248-1dc79040f3ad","790bd194-79b5-4d3d-b43a-ec342482981e"],"security":["a0177fc0-042b-4625-a1c4-9a855bdea4a9"],"path":"/v1/employees/{id}","baseUrlOptions":["https://api.secfix.com","https://api-staging.secfix.com"],"title":"Get an employee","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ae307596-9273-4b98-ae7c-556537ac5a5f":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"cd923e76-8769-41ab-bcf1-4ecfd73736af":{"description":"Employee returned.","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current rate-limit window.","style":"simple","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current rate-limit window.","style":"simple","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the rate-limit window resets.","style":"simple","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email address.","example":"alice@example.com","uniqueKey":"email","typeLabel":"string"},"endContractDate":{"type":"string","description":"Contract end date. Left out when unknown.","format":"date","example":"2026-12-31T00:00:00.000Z","uniqueKey":"endContractDate","typeLabel":"string\u003cdate>"},"groupId":{"type":"string","description":"The `id` of the employee's group (see `GET /v1/groups`). Left out when the employee has no group.","format":"uuid","example":"9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e","uniqueKey":"groupId","typeLabel":"string\u003cuuid>"},"groupName":{"type":"string","description":"Name of the employee's group. Left out when the employee has no group.","example":"Engineering","uniqueKey":"groupName","typeLabel":"string"},"id":{"type":"string","description":"The employee's id (UUID).","format":"uuid","example":"3f1c9a2e-94b1-4d72-a7d8-123456789abc","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Full name.","example":"Alice Doe","uniqueKey":"name","typeLabel":"string"},"onboardingStatus":{"type":"string","description":"Onboarding status, computed from the employee's tasks in this workspace the same way as on the **People** page in Secfix. `NOT_APPLICABLE` for a terminated employee or one with no applicable tasks. If the employee belongs to more than one workspace, the **People** page currently also counts tasks from the other workspaces, so the two can differ.","example":"ONGOING","enum":["COMPLETE","INCOMPLETE","ONGOING","NOT_APPLICABLE"],"uniqueKey":"onboardingStatus","typeLabel":"enum\u003cstring>"},"source":{"type":"string","description":"Where the record comes from.","example":"GOOGLE_WORKSPACE","enum":["GOOGLE_WORKSPACE","MANUAL","MS_OFFICE365","RETOOL","HRIS"],"uniqueKey":"source","typeLabel":"enum\u003cstring>"},"startContractDate":{"type":"string","description":"Contract start date. Left out when unknown.","format":"date","example":"2025-01-15T00:00:00.000Z","uniqueKey":"startContractDate","typeLabel":"string\u003cdate>"},"status":{"type":"string","description":"Employment status. `TERMINATED` once the employee is archived or deleted in Secfix.","example":"ACTIVE","enum":["ACTIVE","TERMINATED"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"tasksSummary":{"type":"object","properties":{"deviceMonitoring":{"type":"object","properties":{"completed":{"type":"integer","description":"Number of tasks in this category the employee has completed.","format":"int32","example":1,"uniqueKey":"tasksSummary.deviceMonitoring.completed","typeLabel":"integer\u003cint32>"},"status":{"type":"string","description":"Onboarding status of this category's tasks.","example":"ONGOING","enum":["COMPLETE","INCOMPLETE","ONGOING","NOT_APPLICABLE"],"uniqueKey":"tasksSummary.deviceMonitoring.status","typeLabel":"enum\u003cstring>"},"total":{"type":"integer","description":"Number of tasks in this category that apply to the employee: not marked N/A, and enabled for your workspace's frameworks.","format":"int32","example":2,"uniqueKey":"tasksSummary.deviceMonitoring.total","typeLabel":"integer\u003cint32>"}},"description":"Onboarding progress in one task category.","uniqueKey":"tasksSummary.deviceMonitoring","typeLabel":"object"},"policyAcceptance":{"type":"object","properties":{"completed":{"type":"integer","description":"Number of tasks in this category the employee has completed.","format":"int32","example":1,"uniqueKey":"tasksSummary.policyAcceptance.completed","typeLabel":"integer\u003cint32>"},"status":{"type":"string","description":"Onboarding status of this category's tasks.","example":"ONGOING","enum":["COMPLETE","INCOMPLETE","ONGOING","NOT_APPLICABLE"],"uniqueKey":"tasksSummary.policyAcceptance.status","typeLabel":"enum\u003cstring>"},"total":{"type":"integer","description":"Number of tasks in this category that apply to the employee: not marked N/A, and enabled for your workspace's frameworks.","format":"int32","example":2,"uniqueKey":"tasksSummary.policyAcceptance.total","typeLabel":"integer\u003cint32>"}},"description":"Onboarding progress in one task category.","uniqueKey":"tasksSummary.policyAcceptance","typeLabel":"object"},"tasks":{"type":"array","description":"The tasks that can be assigned to the employee and are enabled for your workspace's frameworks, in the order Secfix shows them.","items":{"type":"object","properties":{"category":{"type":"string","description":"Task category.","example":"TRAINING","enum":["MONITORING","TRAINING","POLICIES"],"uniqueKey":"tasksSummary.tasks.items.[INDEX].category","typeLabel":"enum\u003cstring>"},"completedAt":{"type":"string","description":"When the task was completed. Left out if it hasn't been.","format":"date-time","example":"2026-03-02T09:15:00.000Z","uniqueKey":"tasksSummary.tasks.items.[INDEX].completedAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","description":"When the completed task expires, for recurring trainings. Left out if it doesn't expire.","format":"date-time","example":"2027-03-02T00:00:00.000Z","uniqueKey":"tasksSummary.tasks.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time>"},"key":{"type":"string","description":"Task key, such as `SECURITY_AWARENESS_TRAINING`, `POLICIES_ACCEPTANCE` or `SECFIX_AGENT`. New keys can be added, so handle keys you don't know.","example":"SECURITY_AWARENESS_TRAINING","uniqueKey":"tasksSummary.tasks.items.[INDEX].key","typeLabel":"string"},"name":{"type":"string","description":"Task name as shown in Secfix.","example":"Security awareness training","uniqueKey":"tasksSummary.tasks.items.[INDEX].name","typeLabel":"string"},"status":{"type":"string","description":"Task status, as shown on the employee's page in Secfix. An expired task is `INCOMPLETE`. A hidden task is `NOT_APPLICABLE`, and so is every task of an active employee whose onboarding is `NOT_APPLICABLE`. A terminated employee's tasks keep their real status.","example":"COMPLETE","enum":["COMPLETE","INCOMPLETE","NOT_APPLICABLE"],"uniqueKey":"tasksSummary.tasks.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"description":"One onboarding task of the employee, as listed on their page in Secfix.","uniqueKey":"tasksSummary.tasks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"tasksSummary.tasks","typeLabel":"object[]"},"trainings":{"type":"object","properties":{"completed":{"type":"integer","description":"Number of tasks in this category the employee has completed.","format":"int32","example":1,"uniqueKey":"tasksSummary.trainings.completed","typeLabel":"integer\u003cint32>"},"status":{"type":"string","description":"Onboarding status of this category's tasks.","example":"ONGOING","enum":["COMPLETE","INCOMPLETE","ONGOING","NOT_APPLICABLE"],"uniqueKey":"tasksSummary.trainings.status","typeLabel":"enum\u003cstring>"},"total":{"type":"integer","description":"Number of tasks in this category that apply to the employee: not marked N/A, and enabled for your workspace's frameworks.","format":"int32","example":2,"uniqueKey":"tasksSummary.trainings.total","typeLabel":"integer\u003cint32>"}},"description":"Onboarding progress in one task category.","uniqueKey":"tasksSummary.trainings","typeLabel":"object"}},"description":"Onboarding progress by task category, and the employee's tasks.","uniqueKey":"tasksSummary","typeLabel":"object"}},"description":"A person in your workspace and their onboarding progress.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"alice@example.com","endContractDate":"2026-12-31T00:00:00.000Z","groupId":"9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e","groupName":"Engineering","id":"3f1c9a2e-94b1-4d72-a7d8-123456789abc","name":"Alice Doe","onboardingStatus":"ONGOING","source":"GOOGLE_WORKSPACE","startContractDate":"2025-01-15T00:00:00.000Z","status":"ACTIVE","tasksSummary":{"deviceMonitoring":{"completed":1,"status":"ONGOING","total":2},"policyAcceptance":{"completed":1,"status":"ONGOING","total":2},"tasks":[{"category":"TRAINING","completedAt":"2026-03-02T09:15:00.000Z","expiresAt":"2027-03-02T00:00:00.000Z","key":"SECURITY_AWARENESS_TRAINING","name":"Security awareness training","status":"COMPLETE"}],"trainings":{"completed":1,"status":"ONGOING","total":2}}}}},"exampleType":"generated"}},"exampleType":"generated"},"5e5b44af-5d30-4762-ae5e-bedf5bbbecce":{"description":"The access token is missing, invalid or replaced by a newer one. Code: `unauthorized` or `token_superseded`.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"d9298e48-45d0-4db5-a221-a0ecc7e9775a":{"description":"The access token doesn't have the scope this endpoint needs. Code: `scope_required`.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"d4335180-dd88-454a-9c07-1b0af3bebfd5":{"description":"No employee with this `id` exists in your workspace. Code: `not_found`.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"13f1e510-d266-4b79-adb2-ee28788a8649":{"description":"This path doesn't support the HTTP method. The `Allow` header lists the methods it supports. Code: `method_not_allowed`.","headers":{"Allow":{"description":"Comma-separated list of the HTTP methods this path supports.","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"a03d4e0d-f758-47fd-8c99-506b8299d655":{"description":"Too many requests. Wait the number of seconds in `Retry-After`, then retry. Code: `rate_limited`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","style":"simple","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"},"97676f4e-1a2e-4492-ae89-7d6cdc07921f":{"description":"Unexpected server error. Code: `internal_error`.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code for your error handling. It doesn't change between releases.","example":"not_found","uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"What went wrong in this request.","example":"No asset found for the given id.","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","description":"URI that identifies this occurrence of the error.","example":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","uniqueKey":"instance","typeLabel":"string"},"requestId":{"type":"string","description":"The request's id, also sent in the `X-Request-Id` header. Include it when you contact support.","example":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","uniqueKey":"requestId","typeLabel":"string"},"status":{"type":"integer","description":"HTTP status code.","format":"int32","example":404,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","description":"Short summary of the error type.","example":"Not Found","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","description":"URI that identifies the error type.","example":"https://api.secfix.com/problems/not_found","uniqueKey":"type","typeLabel":"string"}},"description":"The JSON body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"not_found","detail":"No asset found for the given id.","instance":"/v1/inventory/assets/3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f","requestId":"req_01HZY8Q3M4N5P6R7S8T9V0W1X2","status":404,"title":"Not Found","type":"https://api.secfix.com/problems/not_found"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a0177fc0-042b-4625-a1c4-9a855bdea4a9":{"bearerAuth":{"type":"http","description":"Access token from `POST /oauth/token`.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"4f2cec6e-2289-49a2-8248-1dc79040f3ad":{"url":"https://api.secfix.com","description":"Production"},"790bd194-79b5-4d3d-b43a-ec342482981e":{"url":"https://api-staging.secfix.com","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"Access token from `POST /oauth/token`.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Access token from `POST /oauth/token`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"developer-staging-secfix","siteName":"Secfix Developers (Staging)","title":"Get an employee - Secfix Developers (Staging)","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T15:17:32.671Z","originalFileLocation":"api-reference/employees/get-an-employee.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 active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Secfix Developers (Staging)\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an employee - Secfix Developers (Staging)\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Secfix Developers (Staging)\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://developer-staging-secfix.mintlify.site/_mintlify/api/og/v2?division=Employees\u0026amp;title=Get+an+employee\u0026amp;description=Returns+active+and+terminated+employees.+An+unknown+%60id%60%2C+an+%60id%60+from+another+workspace+and+a+service+account+all+return+404.+Requires+the+%60all%3Aread%60+scope.\u0026amp;theme=d051878f67505cd781ea0506\u0026amp;signature=96d32d7bcd66a27c742ca7da676a541b68f5de2fd4d098a73079af111a1b3349\">\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 an employee - Secfix Developers (Staging)\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://developer-staging-secfix.mintlify.site/_mintlify/api/og/v2?division=Employees\u0026amp;title=Get+an+employee\u0026amp;description=Returns+active+and+terminated+employees.+An+unknown+%60id%60%2C+an+%60id%60+from+another+workspace+and+a+service+account+all+return+404.+Requires+the+%60all%3Aread%60+scope.\u0026amp;theme=d051878f67505cd781ea0506\u0026amp;signature=96d32d7bcd66a27c742ca7da676a541b68f5de2fd4d098a73079af111a1b3349\">\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/developer-staging-secfix/Q-RAuUtgnc9yPmKP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Secfix Developers (Staging)\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#762EEA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/employees/get-an-employee.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer-staging.secfix.com/#organization\",\"name\":\"Secfix Developers (Staging)\",\"url\":\"https://developer-staging.secfix.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/developer-staging-secfix/Q-9vTGgOSlO8yeFU/logo/light.svg?fit=max\u0026auto=format\u0026n=Q-9vTGgOSlO8yeFU\u0026q=85\u0026s=b6e2ca2f07e816208bdf37e60752ad07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer-staging.secfix.com#website\",\"name\":\"Secfix Developers (Staging)\",\"url\":\"https://developer-staging.secfix.com\",\"publisher\":{\"@id\":\"https://developer-staging.secfix.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee#webpage\",\"url\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee\",\"name\":\"Get an employee\",\"description\":\"Returns active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.\",\"dateModified\":\"2026-11-04T15:17:32.671Z\",\"isPartOf\":{\"@id\":\"https://developer-staging.secfix.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://developer-staging.secfix.com/api-reference/oauth/get-an-access-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Employees\",\"item\":\"https://developer-staging.secfix.com/api-reference/employees/list-employees\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get an employee\",\"item\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee#apireference\",\"headline\":\"Get an employee\",\"name\":\"Get an employee\",\"description\":\"Returns active and terminated employees. An unknown id, an id from another workspace and a service account all return 404. Requires the all:read scope.\",\"url\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee\",\"mainEntityOfPage\":{\"@id\":\"https://developer-staging.secfix.com/api-reference/employees/get-an-employee#webpage\"},\"dateModified\":\"2026-11-04T15:17:32.671Z\",\"publisher\":{\"@id\":\"https://developer-staging.secfix.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer-staging.secfix.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Secfix Developers (Staging)\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Secfix Developers (Staging)","nav":{"global":{"anchors":[{"anchor":"Support","icon":"envelope","href":"mailto:support@secfix.com"},{"anchor":"Secfix.com","icon":"globe","href":"https://secfix.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Overview","href":"/api-reference/overview"}]},{"group":"Endpoints","pages":[{"group":"OAuth","pages":[{"title":"Get an access token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /oauth/token","href":"/api-reference/oauth/get-an-access-token"}]},{"group":"Computers","pages":[{"title":"List computers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/computers","href":"/api-reference/computers/list-computers"},{"title":"Get a computer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/computers/{id}","href":"/api-reference/computers/get-a-computer"}]},{"group":"Employees","pages":[{"title":"List employees","description":"Returns the people in your workspace who are included in compliance. Only active employees are returned unless you set `status`. Service accounts are never returned. Filters combine with AND. To pass several values to one filter, separate them with commas: `group=Engineering,Sales`. Names and email addresses are personal data. Requires the `all:read` scope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/employees","href":"/api-reference/employees/list-employees"},{"title":"Get an employee","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/employees/{id}","href":"/api-reference/employees/get-an-employee"}]},{"group":"Groups","pages":[{"title":"List groups","description":"Returns the employee groups in your workspace, oldest first. Requires the `all:read` scope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/groups","href":"/api-reference/groups/list-groups"},{"title":"Get a group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/groups/{id}","href":"/api-reference/groups/get-a-group"}]},{"group":"Health","pages":[{"title":"Check API health","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/health","href":"/api-reference/health/check-api-health"}]},{"group":"Inventory","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/inventory/assets","href":"/api-reference/inventory/list-assets"},{"title":"Create or update an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/inventory/assets","href":"/api-reference/inventory/create-or-update-an-asset"},{"title":"Create assets in a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/inventory/assets/batch-create","href":"/api-reference/inventory/create-assets-in-a-batch"},{"title":"Delete assets in a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /v1/inventory/assets/batch-delete","href":"/api-reference/inventory/delete-assets-in-a-batch"},{"title":"Update assets in a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/inventory/assets/batch-update","href":"/api-reference/inventory/update-assets-in-a-batch"},{"title":"Get an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/inventory/assets/{id}","href":"/api-reference/inventory/get-an-asset"},{"title":"Delete an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /v1/inventory/assets/{id}","href":"/api-reference/inventory/delete-an-asset"},{"title":"Update an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /v1/inventory/assets/{id}","href":"/api-reference/inventory/update-an-asset"},{"title":"List asset categories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /v1/inventory/categories","href":"/api-reference/inventory/list-asset-categories"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get an employee - Secfix Developers (Staging)","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-Cj6eAYhz.js","dist-CdrJecqK.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D-TRO5q5.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","AssistantPageLink-CHlcWBLM.js"]}