Note: Income information is returned as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.
The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted. Required when the connection has more than one entity — omitting it returns a 400invalid_request_error. Optional for single-entity connections.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finch","colors":{"primary":"#161616","light":"#FAFAFA","dark":"#3E4AE7"},"logo":{"light":"https://mintcdn.com/finch/ejF2Kw2CeeMQKCJw/logo/logo-black.svg?fit=max\u0026auto=format\u0026n=ejF2Kw2CeeMQKCJw\u0026q=85\u0026s=e490dba98fb7b16e8f9f5ab4a9a58a5c","dark":"https://mintcdn.com/finch/ejF2Kw2CeeMQKCJw/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=ejF2Kw2CeeMQKCJw\u0026q=85\u0026s=9132a1fde9ad8880fbf81ac32e53e6b2"},"favicon":"https://mintcdn.com/finch/8U6M212KK5wde_yD/favicon.png?fit=max\u0026auto=format\u0026n=8U6M212KK5wde_yD\u0026q=85\u0026s=c54c63bf4768a5eb32ea7e306f52ed1e","navbar":{"links":[{"href":"https://dashboard.tryfinch.com/signup","label":"Sign Up"}],"primary":{"type":"button","label":"Sign In","href":"https://login.tryfinch.com/u/login?state=hKFo2SBmakdGQlE4STYwYzhmRkYzc0ZOTVV3c1VkX2F4UGhuTKFur3VuaXZlcnNhbC1sb2dpbqN0aWTZIENuZ0NHU283dXV5YzlzczQtZFZxUmJQRElJUmt6UGpmo2NpZNkgTlZsT1hZN3N2R25xSlNHYkFSdE1Ga2tnMGJqMkJmbEk"}},"footer":{"socials":{"twitter":"https://twitter.com/tryfinch?lang=en","linkedin":"https://www.linkedin.com/company/finchapi","website":"https://tryfinch.com/"}},"integrations":{"amplitude":{"apiKey":"684ff58ac8711b102376cfd6ded7f199"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":{"style":"sharp-solid","name":"megaphone"},"color":{"light":"#3E4AE7","dark":"#3E4AE7"},"href":"https://developer.tryfinch.com/changelog"},{"anchor":"API Status","icon":{"style":"sharp-solid","name":"signal-bars"},"color":{"light":"#3E4AE7","dark":"#3E4AE7"},"href":"https://status.tryfinch.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"finch","hasAudioNarration":false,"actualSubdomain":"finch","customDomains":["developer.tryfinch.com"],"gitSource":{"type":"github","owner":"finch-api","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae10e005ecac0fee57ea23e","collectionId":"98c9829e-3fbd-4c02-b4dc-52a4844bcf4b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae10e005ecac0fee57ea23e"},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae10e005ecac0fee57ea23e","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":61},{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"Implementation Guide","count":23},{"language":"default","tag":"Developer Resources","count":17},{"language":"default","tag":"Sandbox","count":11},{"language":"default","tag":"Management","count":10},{"language":"default","tag":"Payroll","count":10},{"language":"default","tag":"Deductions","count":9},{"language":"default","tag":"Development Guides","count":7},{"language":"default","tag":"Build Backend Application","count":7}]},"assistantConfig":{"deflection":{"enabled":true,"email":"developers@tryfinch.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--finch-purple:#3E4AE7;--finch-purple-dark:#7A84FF}.update-container [class*=bg-primary]{background-color:rgba(62,74,231,.08)!important;color:var(--finch-purple)!important}.dark .update-container [class*=bg-primary]{background-color:rgba(122,132,255,.15)!important;color:var(--finch-purple-dark)!important}#content-side-layout:empty,#table-of-contents-layout:empty{position:absolute}:is(.prose a):not(.dark .prose a):not(:where([aria-label=\"Navigate to header\"])){color:var(--finch-purple);border-bottom:1px solid var(--finch-purple)}:is(.dark .prose a):not(:where([aria-label=\"Navigate to header\"])){color:var(--finch-purple-dark);border-bottom:1px solid var(--finch-purple-dark)}.automated-badge{background-color:#ecfdf3;color:#027a48}.assisted-badge{background-color:#fffaeb;color:#b54708}.dark .automated-badge{background-color:#0c2119!important;color:#12b76a!important}.dark .assisted-badge{background-color:#21140f!important;color:#f79009!important}.pn-container{margin-top:1rem}.pn-search{width:100%;padding:10px 14px;font-size:15px;border:1px solid #d0d5dd;border-radius:8px;outline:0;background:#fff;color:#101828;transition:border-color .15s,box-shadow .15s}.pn-search:focus{border-color:var(--finch-purple);box-shadow:0 0 0 3px rgba(62,74,231,.12)}.pn-search::placeholder{color:#98a2b3}.dark .pn-search{background:#1d2939;border-color:#344054;color:#f2f4f7}.dark .pn-search:focus{border-color:var(--finch-purple-dark);box-shadow:0 0 0 3px rgba(122,132,255,.15)}.pn-filters{display:flex;flex-wrap:wrap;gap:16px;margin:16px 0;align-items:flex-start}.pn-filter-group{display:flex;align-items:center;gap:6px;flex-wrap:wrap}.pn-filter-label,.pn-table thead th{font-weight:600;color:#475467;white-space:nowrap}.pn-filter-label{font-size:13px;margin-right:2px}.dark .pn-filter-label{color:#98a2b3}.pn-checkbox-label,.pn-export-btn,.pn-filter-btn{align-items:center;font-size:13px;font-weight:500;cursor:pointer}.pn-checkbox-label{display:flex;gap:6px;color:#344054}.dark .pn-checkbox-label{color:#d0d5dd}.pn-export-btn,.pn-filter-btn{display:inline-flex;padding:4px 12px;border:1px solid #d0d5dd}.pn-export-btn{gap:6px;border-radius:6px;background:0 0;color:#475467;margin-left:auto}.pn-export-btn:hover{background:#f2f4f7;border-color:#98a2b3}.dark .pn-export-btn{color:#d0d5dd;border-color:#475467}.dark .pn-export-btn:hover{background:#1d2939;border-color:#667085}.pn-filter-btn{border-radius:999px;background:#fff;color:#344054;transition:all .15s;line-height:1.5}.pn-filter-btn:hover{background:#f2f4f7;border-color:#98a2b3}.pn-filter-btn-active{background:var(--finch-purple)!important;color:#fff!important;border-color:var(--finch-purple)!important}.dark .pn-filter-btn{background:#1d2939;border-color:#344054;color:#d0d5dd}.dark .pn-filter-btn:hover{background:#344054;border-color:#475467}.dark .pn-filter-btn-active{background:var(--finch-purple-dark)!important;color:#101828!important;border-color:var(--finch-purple-dark)!important}.pn-results-count{font-size:14px;color:#475467;margin-bottom:12px;font-weight:500}.dark .pn-results-count{color:#98a2b3}.pn-table{width:100%;border-collapse:collapse;font-size:14px;table-layout:auto;margin-left:0!important;margin-right:0!important}#fsm-table-scroll table td,#fsm-table-scroll table th,.pn-table td,.pn-table th{min-width:0!important}.pn-col-narrow{width:1%!important}.pn-td-center,.pn-th-center{text-align:center!important;white-space:nowrap!important;padding-left:6px!important;padding-right:6px!important;width:1%!important;min-width:0!important;max-width:fit-content!important}.pn-th-link,.pn-th-link:link,.pn-th-link:visited,.prose .pn-th-link,.prose a.pn-th-link{color:inherit!important;text-decoration:none!important;border-bottom:none!important;box-shadow:none!important}.pn-th-link:hover,.prose .pn-th-link:hover,.prose a.pn-th-link:hover{text-decoration:underline!important}.pn-table thead th{text-align:left;padding:8px 4px;font-size:12px;text-transform:uppercase;letter-spacing:.04em;border-bottom:2px solid #e4e7ec}.dark .pn-table thead th{color:#98a2b3;border-bottom-color:#344054}.pn-table tbody tr{border-bottom:1px solid #f2f4f7;transition:background .1s}.pn-table tbody tr:hover{background:#f9fafb}.dark .pn-table tbody tr{border-bottom-color:#1d2939}.dark .pn-table tbody tr:hover{background:#1d2939}.pn-table td{padding:8px 4px;vertical-align:middle;overflow:hidden;text-overflow:ellipsis}.pn-table td:first-child,.pn-table th:first-child{padding-left:0!important}.pn-pill{display:inline-block;padding:2px 8px;border-radius:999px;font-size:13px;font-weight:500}.pn-product-pills{display:flex;flex-wrap:wrap;gap:4px}.pn-pill-automated{background:#ecfdf3;color:#027a48}.pn-pill-assisted{background:#fffaeb;color:#b54708}.dark .pn-pill-automated{background:#0c2119;color:#12b76a}.dark .pn-pill-assisted{background:#21140f;color:#f79009}.pn-name-row{display:flex;align-items:center;gap:8px}.pn-name-id{gap:6px}.pn-copy-btn,.pn-id-cell,.pn-name-id{display:inline-flex;align-items:center}.pn-id-cell{gap:4px}.pn-id-cell code{font-size:12px}.pn-copy-btn{justify-content:center;background:0 0;border:0;cursor:pointer;color:#98a2b3;padding:2px;border-radius:4px;transition:color .15s,background .15s}.pn-copy-btn:hover{color:var(--finch-purple);background:#f2f4f7}.dark .pn-copy-btn:hover{color:var(--finch-purple-dark);background:#344054}.assisted-fast-badge,.pn-badge-assisted,.pn-badge-assisted-fast,.pn-badge-automated{display:inline-block;padding:1px 6px;border-radius:999px;font-size:11px;font-weight:500;white-space:nowrap}.assisted-fast-badge,.pn-badge-assisted-fast{background-color:#fffaeb;color:#b54708}.dark .assisted-fast-badge{background-color:#21140f!important;color:#f79009!important}.pn-badge-none{color:#98a2b3;font-size:11px}.pn-badge-request,.prose .pn-badge-request,.prose a.pn-badge-request{font-size:11px;color:#667085!important;text-decoration:none!important;border-bottom:none!important}.pn-badge-request:hover,.prose .pn-badge-request:hover,.prose a.pn-badge-request:hover{text-decoration:underline!important}.dark .pn-badge-request,.dark .prose .pn-badge-request,.dark .prose a.pn-badge-request{color:#667085!important}.pn-status-beta,.pn-status-ga{display:inline-block;padding:1px 6px;border-radius:999px;font-size:10px;font-weight:600;letter-spacing:.03em}.pn-status-ga{background:#eff8ff;color:#175cd3;text-transform:uppercase}.pn-status-beta{background:#f4f3ff;color:#5925dc}.dark .pn-status-ga{background:#0c1f3d;color:#84adff}.dark .pn-status-beta{background:#1d1547;color:#bdb4fe}@media (max-width:768px){.pn-filters{flex-direction:column;gap:10px}.pn-table{font-size:12px}.pn-table td,.pn-table th{padding:8px 6px}}.fsm-auth-api_token,.fsm-auth-assisted,.fsm-auth-credential,.fsm-auth-oauth{font-size:11px;font-weight:500;padding:2px 8px;border-radius:9999px;display:inline-block}.fsm-auth-oauth{background:#f0fdf4;color:#15803d}.fsm-auth-credential{background:#eff6ff;color:#1d4ed8}.fsm-auth-api_token{background:#faf5ff;color:#7e22ce}.fsm-auth-assisted{background:#fefce8;color:#a16207}.dark .fsm-auth-oauth{background:#0a2618;color:#6ee7a0}.dark .fsm-auth-credential{background:#0c1a2e;color:#7db8f5}.dark .fsm-auth-api_token{background:#1a0e2e;color:#c4a5f5}.dark .fsm-auth-assisted{background:#231a0a;color:#e5b85c}.fsm-beta-callout{border-radius:8px;border:1px solid #bfdbfe;background:#eff6ff;padding:12px 16px;margin-bottom:16px;font-size:14px;color:#1e40af;display:flex;align-items:center;gap:10px}.fsm-beta-callout svg,.fsm-method{flex-shrink:0}.dark .fsm-beta-callout{border-color:#1e3a5f;background:#0c1a2e;color:#93c5fd}.dark .fsm-beta-callout circle{stroke:#60a5fa}.dark .fsm-beta-callout text{fill:#60a5fa}.fsm-method{font-size:9px;font-weight:700;line-height:1;padding:2px 5px;border-radius:3px;letter-spacing:.02em}.fsm-method-get{color:#16a34a;background:#f0fdf4}.fsm-method-post{color:#2563eb;background:#eff6ff}.fsm-method-del{color:#dc2626;background:#fef2f2}.dark .fsm-method-get{color:#6ee7a0;background:#0a2618}.dark .fsm-method-post{color:#7db8f5;background:#0c1a2e}.dark .fsm-method-del{color:#f87171;background:#2a0a0a}.fsm-csv-btn,.fsm-drop-item{align-items:center;font-size:13px;cursor:pointer;background:0 0}.fsm-csv-btn{display:inline-flex;gap:6px;padding:7px 12px;border:1px solid #e2e8f0;border-radius:8px;font-weight:500;color:#64748b}.fsm-csv-btn:hover{border-color:#94a3b8;color:#475569}.dark .fsm-csv-btn{border-color:#374151;color:#9ca3af}.dark .fsm-csv-btn:hover{border-color:#4b5563;color:#d1d5db}.fsm-drop-item{display:flex;gap:8px;width:100%;padding:5px 10px;border:0;border-radius:6px;text-align:left;color:#4b5563}.fsm-drop-item:hover{background:#f8fafc}.fsm-drop-item-selected{background:#f0f1ff;color:#3e4ae7}.dark .fsm-drop-item{color:#e5e7eb}.dark .fsm-drop-item:hover{background:rgba(255,255,255,.08)}.dark .fsm-drop-item-selected{background:rgba(122,132,255,.15);color:#7a84ff}.fsm-tooltip-wrap{position:relative;display:inline-flex}.fsm-tooltip{display:none;position:absolute;bottom:calc(100% + 6px);left:50%;transform:translateX(-50%);background:#1e293b;color:#f1f5f9;font-size:12px;line-height:1.4;padding:8px 12px;border-radius:8px;width:220px;white-space:normal;text-align:left;box-shadow:0 4px 12px rgba(0,0,0,.15);z-index:100;pointer-events:none}.fsm-btn-tooltip-wrap:hover .fsm-btn-tooltip,.fsm-tip:hover .fsm-tip-text,.fsm-tooltip-wrap:hover .fsm-tooltip{display:block}.fsm-btn-tooltip-wrap{position:relative;display:inline-flex}.fsm-btn-tooltip{display:none;position:absolute;bottom:calc(100% + 6px);left:50%;transform:translateX(-50%);background:#1e293b;color:#f1f5f9;font-size:11px;padding:4px 8px;border-radius:4px;white-space:nowrap;z-index:100;pointer-events:none}.fsm-tip{color:#9ca3af}.dark .fsm-tip{color:#6b7280}.fsm-tip-text{display:none;position:absolute;bottom:calc(100% + 6px);right:-8px;background:#1e293b;color:#f1f5f9;font-size:11px;line-height:1.4;padding:6px 10px;border-radius:6px;text-align:left;width:max-content;max-width:320px;z-index:9999;pointer-events:none}#fsm-table-scroll,#fsm-top-scroll{margin-left:0!important;margin-right:0!important;max-width:100%!important}#fsm-table-scroll::-webkit-scrollbar,#fsm-top-scroll::-webkit-scrollbar{height:8px}#fsm-table-scroll::-webkit-scrollbar-track,#fsm-top-scroll::-webkit-scrollbar-track{background:0 0}#fsm-table-scroll::-webkit-scrollbar-thumb,#fsm-top-scroll::-webkit-scrollbar-thumb{background:#d1d5db;border-radius:4px}#fsm-table-scroll::-webkit-scrollbar-thumb:hover,#fsm-top-scroll::-webkit-scrollbar-thumb:hover{background:#9ca3af}.dark #fsm-table-scroll::-webkit-scrollbar-thumb,.dark #fsm-top-scroll::-webkit-scrollbar-thumb{background:#4b5563}.dark #fsm-table-scroll::-webkit-scrollbar-thumb:hover,.dark #fsm-top-scroll::-webkit-scrollbar-thumb:hover{background:#6b7280}"}],"page":{"pagePath":"api-reference/organization/employment","slug":"/api-reference/organization/employment","pageMetadata":{"openapi":"post /employer/employment","title":"Employment","description":"Read individual employment and income data","href":"/api-reference/organization/employment"},"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: \"Read individual employment and income data\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Note: Income information is returned as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.`})}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":{"openapi":"post /employer/employment","title":"Employment","description":"Read individual employment and income data","href":"/api-reference/organization/employment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Read individual employment and income data","summary":"Employment","operationId":"get-employment","tags":["Organization"],"parameters":["4f747e79-850e-48b1-8e7a-c1a0e6502e4e","2d5e2ad8-5c82-491b-9e5c-22ceeb2ed04e","666786ab-3099-40b6-811c-3c5d8e1ac7ff"],"requestBody":"02dd31bf-ff5a-40fa-aa94-33e9cd95bae4","security":["6c86a1d1-7c0f-45e1-8fd2-d1dcc65828fe"],"responses":{"200":"afd471db-3753-4c7a-8c1a-2b14bafeee6d","202":"c62b3ded-7171-4621-a05b-ba1c4abea463","400":"e3b72d4e-e004-405f-9cc4-7761ca473f26","422":"4862495f-7f7c-4307-98ad-bec3d0fa7203"},"x-codeSamples":[{"lang":"JavaScript","source":"import Finch from '@tryfinch/finch-api';\n\nconst client = new Finch({\n accessToken: 'My Access Token',\n});\n\n// Automatically fetches more pages as needed.\nfor await (const employmentDataResponse of client.hris.employments.retrieveMany({\n requests: [{ individual_id: 'individual_id' }],\n})) {\n console.log(employmentDataResponse.individual_id);\n}"},{"lang":"Python","source":"from finch import Finch\n\nclient = Finch(\n access_token=\"My Access Token\",\n)\npage = client.hris.employments.retrieve_many(\n requests=[{\n \"individual_id\": \"individual_id\"\n }],\n)\npage = page.responses[0]\nprint(page.individual_id)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/Finch-API/finch-api-go/v2\"\n\t\"github.com/Finch-API/finch-api-go/v2/option\"\n)\n\nfunc main() {\n\tclient := finchgo.NewClient(\n\t\toption.WithAccessToken(\"My Access Token\"),\n\t)\n\tpage, err := client.HRIS.Employments.GetMany(context.TODO(), finchgo.HRISEmploymentGetManyParams{\n\t\tRequests: finchgo.F([]finchgo.HRISEmploymentGetManyParamsRequest{{\n\t\t\tIndividualID: finchgo.F(\"individual_id\"),\n\t\t}}),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n"},{"lang":"Java","source":"package com.tryfinch.api.example;\n\nimport com.tryfinch.api.client.FinchClient;\nimport com.tryfinch.api.client.okhttp.FinchOkHttpClient;\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyPage;\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n FinchClient client = FinchOkHttpClient.builder()\n .fromEnv()\n .accessToken(\"My Access Token\")\n .build();\n\n HrisEmploymentRetrieveManyParams params = HrisEmploymentRetrieveManyParams.builder()\n .addRequest(HrisEmploymentRetrieveManyParams.Request.builder()\n .individualId(\"individual_id\")\n .build())\n .build();\n HrisEmploymentRetrieveManyPage page = client.hris().employments().retrieveMany(params);\n }\n}"},{"lang":"Kotlin","source":"package com.tryfinch.api.example\n\nimport com.tryfinch.api.client.FinchClient\nimport com.tryfinch.api.client.okhttp.FinchOkHttpClient\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyPage\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyParams\n\nfun main() {\n val client: FinchClient = FinchOkHttpClient.builder()\n .fromEnv()\n .accessToken(\"My Access Token\")\n .build()\n\n val params: HrisEmploymentRetrieveManyParams = HrisEmploymentRetrieveManyParams.builder()\n .addRequest(HrisEmploymentRetrieveManyParams.Request.builder()\n .individualId(\"individual_id\")\n .build())\n .build()\n val page: HrisEmploymentRetrieveManyPage = client.hris().employments().retrieveMany(params)\n}"},{"lang":"Ruby","source":"require \"finch_api\"\n\nfinch = FinchAPI::Client.new(access_token: \"My Access Token\")\n\npage = finch.hris.employments.retrieve_many(requests: [{individual_id: \"individual_id\"}])\n\nputs(page)"}],"method":"post","type":"path","servers":["c751b629-e47c-48d2-9131-f14412d7ead8"],"path":"/employer/employment","baseUrlOptions":["https://api.tryfinch.com"],"title":"Employment","codeSamples":[{"lang":"JavaScript","source":"import Finch from '@tryfinch/finch-api';\n\nconst client = new Finch({\n accessToken: 'My Access Token',\n});\n\n// Automatically fetches more pages as needed.\nfor await (const employmentDataResponse of client.hris.employments.retrieveMany({\n requests: [{ individual_id: 'individual_id' }],\n})) {\n console.log(employmentDataResponse.individual_id);\n}"},{"lang":"Python","source":"from finch import Finch\n\nclient = Finch(\n access_token=\"My Access Token\",\n)\npage = client.hris.employments.retrieve_many(\n requests=[{\n \"individual_id\": \"individual_id\"\n }],\n)\npage = page.responses[0]\nprint(page.individual_id)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/Finch-API/finch-api-go/v2\"\n\t\"github.com/Finch-API/finch-api-go/v2/option\"\n)\n\nfunc main() {\n\tclient := finchgo.NewClient(\n\t\toption.WithAccessToken(\"My Access Token\"),\n\t)\n\tpage, err := client.HRIS.Employments.GetMany(context.TODO(), finchgo.HRISEmploymentGetManyParams{\n\t\tRequests: finchgo.F([]finchgo.HRISEmploymentGetManyParamsRequest{{\n\t\t\tIndividualID: finchgo.F(\"individual_id\"),\n\t\t}}),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n"},{"lang":"Java","source":"package com.tryfinch.api.example;\n\nimport com.tryfinch.api.client.FinchClient;\nimport com.tryfinch.api.client.okhttp.FinchOkHttpClient;\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyPage;\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n FinchClient client = FinchOkHttpClient.builder()\n .fromEnv()\n .accessToken(\"My Access Token\")\n .build();\n\n HrisEmploymentRetrieveManyParams params = HrisEmploymentRetrieveManyParams.builder()\n .addRequest(HrisEmploymentRetrieveManyParams.Request.builder()\n .individualId(\"individual_id\")\n .build())\n .build();\n HrisEmploymentRetrieveManyPage page = client.hris().employments().retrieveMany(params);\n }\n}"},{"lang":"Kotlin","source":"package com.tryfinch.api.example\n\nimport com.tryfinch.api.client.FinchClient\nimport com.tryfinch.api.client.okhttp.FinchOkHttpClient\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyPage\nimport com.tryfinch.api.models.HrisEmploymentRetrieveManyParams\n\nfun main() {\n val client: FinchClient = FinchOkHttpClient.builder()\n .fromEnv()\n .accessToken(\"My Access Token\")\n .build()\n\n val params: HrisEmploymentRetrieveManyParams = HrisEmploymentRetrieveManyParams.builder()\n .addRequest(HrisEmploymentRetrieveManyParams.Request.builder()\n .individualId(\"individual_id\")\n .build())\n .build()\n val page: HrisEmploymentRetrieveManyPage = client.hris().employments().retrieveMany(params)\n}"},{"lang":"Ruby","source":"require \"finch_api\"\n\nfinch = FinchAPI::Client.new(access_token: \"My Access Token\")\n\npage = finch.hris.employments.retrieve_many(requests: [{individual_id: \"individual_id\"}])\n\nputs(page)"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"4f747e79-850e-48b1-8e7a-c1a0e6502e4e":{"name":"entity_ids","in":"query","required":false,"description":"The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted. Required when the connection has more than one entity — omitting it returns a `400` `invalid_request_error`. Optional for single-entity connections.","schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"minItems":1,"maxItems":1,"example":["550e8400-e29b-41d4-a716-446655440000"],"isRequired":false,"description":"The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted. Required when the connection has more than one entity — omitting it returns a `400` `invalid_request_error`. Optional for single-entity connections.","uniqueKey":"","typeLabel":"string\u003cuuid>[]"},"style":"form","explode":true},"2d5e2ad8-5c82-491b-9e5c-22ceeb2ed04e":{"name":"Finch-API-Version","in":"header","required":true,"schema":{"type":"string","default":"2020-09-17","format":"date","isRequired":true,"description":"Header used to specify the version for a given API request. Current version is 2020-09-17.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Header used to specify the version for a given API request. Current version is 2020-09-17.","x-stainless-param":false},"666786ab-3099-40b6-811c-3c5d8e1ac7ff":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","default":"application/json","isRequired":true,"description":"Used to indicate the original media type of the resource ","uniqueKey":"","typeLabel":"string"},"description":"Used to indicate the original media type of the resource ","x-stainless-param":false}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Individual Ids Request Body","properties":{"requests":{"type":"array","description":"The array of batch requests. Maximum 10000 items per request.","maxItems":10000,"items":{"type":"object","properties":{"individual_id":{"type":"string","description":"A stable Finch `id` (UUID v4) for an individual in the company.","isRequired":true,"uniqueKey":"requests.items.[INDEX].individual_id","typeLabel":"string"}},"required":["individual_id"],"uniqueKey":"requests.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requests","typeLabel":"object[]"}},"required":["requests"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"requests":[{"individual_id":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"afd471db-3753-4c7a-8c1a-2b14bafeee6d":{"description":"Employment data","content":{"application/json":{"schema":{"type":"object","properties":{"responses":{"type":"array","items":{"type":"object","properties":{"individual_id":{"type":"string","description":"A stable Finch `id` (UUID v4) for an individual in the company.","format":"uuid","isRequired":true,"uniqueKey":"responses.items.[INDEX].individual_id","typeLabel":"string\u003cuuid>"},"code":{"type":"integer","isRequired":true,"uniqueKey":"responses.items.[INDEX].code","typeLabel":"integer"},"body":{"oneOf":[{"type":"object","title":"EmploymentDataResponseBody","required":["first_name","middle_name","last_name","title","manager","department","employment","start_date","end_date","latest_rehire_date","is_active","employment_status","flsa_status","union_code","union_local","benefit_eligibility_class","highly_compensated_employee","key_employee","class_code","location","id"],"properties":{"first_name":{"oneOf":[{"type":"string","description":"The legal first name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.first_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The legal first name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.first_name","typeLabel":"string | null"},"middle_name":{"oneOf":[{"type":"string","description":"The legal middle name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.middle_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The legal middle name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.middle_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.middle_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","description":"The legal last name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.last_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The legal last name of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.last_name","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"The current title of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"The current title of the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.title","typeLabel":"string | null"},"manager":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","description":"A stable Finch `id` (UUID v4) for an individual in the company.","format":"uuid","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.manager.oneOf.0.id","typeLabel":"string\u003cuuid>"}},"required":["id"],"description":"The manager object representing the manager of the individual within the org.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.manager.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","description":"A stable Finch `id` (UUID v4) for an individual in the company.","format":"uuid"}},"required":["id"],"description":"The manager object representing the manager of the individual within the org.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.manager.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.manager","typeLabel":"object | null"},"department":{"oneOf":[{"type":"object","properties":{"name":{"oneOf":[{"type":"string","description":"The name of the department associated with the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the department associated with the individual.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department.oneOf.0.name","typeLabel":"string | null"}},"required":["name"],"description":"The department object.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"name":{"oneOf":[{"type":"string","description":"The name of the department associated with the individual."},{"type":"null","description":"The name of the department associated with the individual."}]}},"required":["name"],"description":"The department object.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.department","typeLabel":"object | null"},"employment":{"oneOf":[{"type":"object","properties":{"type":{"oneOf":[{"type":"string","description":"The main employment type of the individual.","enum":["employee","contractor",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The main employment type of the individual.","enum":["employee","contractor",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.type","typeLabel":"enum\u003cstring> | null"},"subtype":{"oneOf":[{"type":"string","description":"The secondary employment type of the individual. Options: `full_time`, `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.","enum":["full_time","intern","part_time","temp","seasonal","individual_contractor",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.subtype.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The secondary employment type of the individual. Options: `full_time`, `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.","enum":["full_time","intern","part_time","temp","seasonal","individual_contractor",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.subtype.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0.subtype","typeLabel":"enum\u003cstring> | null"}},"required":["type","subtype"],"description":"The employment object.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"type":{"oneOf":[{"type":"string","description":"The main employment type of the individual.","enum":["employee","contractor",null]},{"type":"null","description":"The main employment type of the individual.","enum":["employee","contractor",null]}]},"subtype":{"oneOf":[{"type":"string","description":"The secondary employment type of the individual. Options: `full_time`, `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.","enum":["full_time","intern","part_time","temp","seasonal","individual_contractor",null]},{"type":"null","description":"The secondary employment type of the individual. Options: `full_time`, `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.","enum":["full_time","intern","part_time","temp","seasonal","individual_contractor",null]}]}},"required":["type","subtype"],"description":"The employment object.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment","typeLabel":"object | null"},"start_date":{"oneOf":[{"type":"string","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.start_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.end_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.end_date","typeLabel":"string | null"},"latest_rehire_date":{"oneOf":[{"type":"string","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.latest_rehire_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.latest_rehire_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.latest_rehire_date","typeLabel":"string | null"},"is_active":{"oneOf":[{"type":"boolean","description":"`true` if the individual an an active employee or contractor at the company.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.is_active.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"`true` if the individual an an active employee or contractor at the company.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.is_active.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.is_active","typeLabel":"boolean | null"},"employment_status":{"oneOf":[{"type":"string","description":"The detailed employment status of the individual.","enum":["active","deceased","leave","onboarding","prehire","retired","terminated",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The detailed employment status of the individual.","enum":["active","deceased","leave","onboarding","prehire","retired","terminated",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.employment_status","typeLabel":"enum\u003cstring> | null"},"flsa_status":{"oneOf":[{"type":"string","description":"The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `unknown`.","enum":["exempt","non_exempt","unknown",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.flsa_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The FLSA status of the individual. Available options: `exempt`, `non_exempt`, `unknown`.","enum":["exempt","non_exempt","unknown",null],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.flsa_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.flsa_status","typeLabel":"enum\u003cstring> | null"},"union_code":{"oneOf":[{"type":"string","description":"The code identifying the union the employee is a member of, as configured in the payroll system.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The code identifying the union the employee is a member of, as configured in the payroll system.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_code","typeLabel":"string | null"},"union_local":{"oneOf":[{"type":"string","description":"The local chapter or local number within the employee's union.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_local.oneOf.0","typeLabel":"string"},{"type":"null","description":"The local chapter or local number within the employee's union.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_local.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.union_local","typeLabel":"string | null"},"benefit_eligibility_class":{"oneOf":[{"type":"string","description":"The employer defined benefit eligibility class that groups an employee into a set of eligible benefit plans, as stored by the provider. Null when not configured.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.benefit_eligibility_class.oneOf.0","typeLabel":"string"},{"type":"null","description":"The employer defined benefit eligibility class that groups an employee into a set of eligible benefit plans, as stored by the provider. Null when not configured.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.benefit_eligibility_class.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.benefit_eligibility_class","typeLabel":"string | null"},"highly_compensated_employee":{"oneOf":[{"type":"boolean","description":"IRS flag indicating whether the employee is classified as a Highly Compensated Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.highly_compensated_employee.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"IRS flag indicating whether the employee is classified as a Highly Compensated Employee for nondiscrimination testing purposes (ADP/ACP tests). US-only.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.highly_compensated_employee.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.highly_compensated_employee","typeLabel":"boolean | null"},"key_employee":{"oneOf":[{"type":"boolean","description":"IRS flag indicating whether the employee is classified as a Key Employee for top-heavy testing purposes. US-only.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.key_employee.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"IRS flag indicating whether the employee is classified as a Key Employee for top-heavy testing purposes. US-only.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.key_employee.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.key_employee","typeLabel":"boolean | null"},"class_code":{"oneOf":[{"type":"string","description":"Worker's compensation classification code for this employee","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.class_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Worker's compensation classification code for this employee","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.class_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.class_code","typeLabel":"string | null"},"location":{"oneOf":[{"type":"object","properties":{"line1":{"oneOf":[{"type":"string","description":"Street address or PO box.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line1.oneOf.0","typeLabel":"string"},{"type":"null","description":"Street address or PO box.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line1","typeLabel":"string | null"},"line2":{"oneOf":[{"type":"string","description":"Apartment, suite, unit, or building.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Apartment, suite, unit, or building.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.line2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","description":"City, district, suburb, town, or village.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","description":"City, district, suburb, town, or village.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","description":"The state code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.state.oneOf.0","typeLabel":"string"},{"type":"null","description":"The state code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.state.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.state","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","description":"The postal code or zip code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The postal code or zip code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.postal_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.postal_code","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","description":"The 2-letter ISO 3166 country code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"The 2-letter ISO 3166 country code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.country","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.name","typeLabel":"string | null"},"source_id":{"oneOf":[{"type":"string","uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.source_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.source_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0.source_id","typeLabel":"string | null"}},"required":["line1","line2","city","state","postal_code","country"],"description":"","title":"Location","x-tags":["Models"],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.0","typeLabel":"Location · object"},{"type":"null","properties":{"line1":{"oneOf":[{"type":"string","description":"Street address or PO box."},{"type":"null","description":"Street address or PO box."}]},"line2":{"oneOf":[{"type":"string","description":"Apartment, suite, unit, or building."},{"type":"null","description":"Apartment, suite, unit, or building."}]},"city":{"oneOf":[{"type":"string","description":"City, district, suburb, town, or village."},{"type":"null","description":"City, district, suburb, town, or village."}]},"state":{"oneOf":[{"type":"string","description":"The state code."},{"type":"null","description":"The state code."}]},"postal_code":{"oneOf":[{"type":"string","description":"The postal code or zip code."},{"type":"null","description":"The postal code or zip code."}]},"country":{"oneOf":[{"type":"string","description":"The 2-letter ISO 3166 country code."},{"type":"null","description":"The 2-letter ISO 3166 country code."}]},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"source_id":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["line1","line2","city","state","postal_code","country"],"description":"","title":"Location","x-tags":["Models"],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.location","typeLabel":"Location · object | null"},"id":{"type":"string","description":"A stable Finch `id` (UUID v4) for an individual in the company.","format":"uuid","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.id","typeLabel":"string\u003cuuid>"},"income":{"oneOf":[{"type":"object","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.unit","typeLabel":"enum\u003cstring> | null"},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.amount.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The income amount in cents.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.amount","typeLabel":"integer | null"},"currency":{"oneOf":[{"type":"string","description":"The currency code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.currency.oneOf.0","typeLabel":"string"},{"type":"null","description":"The currency code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.currency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.currency","typeLabel":"string | null"},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.effective_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"The date the income amount went into effect.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.effective_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0.effective_date","typeLabel":"string\u003cdate> | null"}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.0","typeLabel":"Income · object"},{"type":"null","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."}]},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents."},{"type":"null","description":"The income amount in cents."}]},"currency":{"oneOf":[{"type":"string","description":"The currency code."},{"type":"null","description":"The currency code."}]},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect."},{"type":"null","format":"date","description":"The date the income amount went into effect."}]}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income","typeLabel":"Income · object | null"},"income_history":{"oneOf":[{"type":"array","description":"The array of income history.","items":{"oneOf":[{"type":"object","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.unit","typeLabel":"enum\u003cstring> | null"},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.amount.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The income amount in cents.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.amount","typeLabel":"integer | null"},"currency":{"oneOf":[{"type":"string","description":"The currency code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.currency.oneOf.0","typeLabel":"string"},{"type":"null","description":"The currency code.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.currency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.currency","typeLabel":"string | null"},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.effective_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"The date the income amount went into effect.","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.effective_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0.effective_date","typeLabel":"string\u003cdate> | null"}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"Income · object"},{"type":"null","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."}]},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents."},{"type":"null","description":"The income amount in cents."}]},"currency":{"oneOf":[{"type":"string","description":"The currency code."},{"type":"null","description":"The currency code."}]},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect."},{"type":"null","format":"date","description":"The date the income amount went into effect."}]}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0.items.[INDEX]","typeLabel":"Income · object | null"},"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.0","typeLabel":"(Income · object | null)[]"},{"type":"null","description":"The array of income history.","items":{"oneOf":[{"type":"object","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."}]},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents."},{"type":"null","description":"The income amount in cents."}]},"currency":{"oneOf":[{"type":"string","description":"The currency code."},{"type":"null","description":"The currency code."}]},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect."},{"type":"null","format":"date","description":"The date the income amount went into effect."}]}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"]},{"type":"null","properties":{"unit":{"oneOf":[{"type":"string","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."},{"type":"null","enum":["yearly","quarterly","monthly","semi_monthly","bi_weekly","weekly","daily","hourly","fixed",null],"description":"The income unit of payment. Options: `yearly`, `quarterly`, `monthly`, `semi_monthly`, `bi_weekly`, `weekly`, `daily`, `hourly`, and `fixed`."}]},"amount":{"oneOf":[{"type":"integer","description":"The income amount in cents."},{"type":"null","description":"The income amount in cents."}]},"currency":{"oneOf":[{"type":"string","description":"The currency code."},{"type":"null","description":"The currency code."}]},"effective_date":{"oneOf":[{"type":"string","format":"date","description":"The date the income amount went into effect."},{"type":"null","format":"date","description":"The date the income amount went into effect."}]}},"required":["unit","amount","currency","effective_date"],"description":"The employee's income as reported by the provider. This may not always be annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc, depending on what information the provider returns.","title":"Income","x-tags":["Models"]}]},"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.income_history","typeLabel":"(Income · object | null)[] | null"},"custom_fields":{"oneOf":[{"type":"array","description":"Custom fields for the individual. These are fields which are defined by the employer in the system. Custom fields are not currently supported for assisted connections.","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"value":{"oneOf":[{"type":["string","array","object","number","boolean","null"],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX].value","typeLabel":"string | null"}},"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Custom fields for the individual. These are fields which are defined by the employer in the system. Custom fields are not currently supported for assisted connections.","items":{"type":"object","properties":{"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"value":{"oneOf":[{"type":["string","array","object","number","boolean","null"]},{"type":"null"}]}}},"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.custom_fields","typeLabel":"object[] | null"},"source_id":{"oneOf":[{"type":"string","description":"The source system's unique employment identifier for this individual","uniqueKey":"responses.items.[INDEX].body.oneOf.0.source_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The source system's unique employment identifier for this individual","uniqueKey":"responses.items.[INDEX].body.oneOf.0.source_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.source_id","typeLabel":"string | null"},"work_id":{"oneOf":[{"type":"string","description":"This field is deprecated in favour of `source_id`","deprecated":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.work_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"This field is deprecated in favour of `source_id`","deprecated":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0.work_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"responses.items.[INDEX].body.oneOf.0.work_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.0","typeLabel":"EmploymentDataResponseBody · object"},{"type":"object","required":["code","message","name"],"properties":{"code":{"type":"number","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.1.code","typeLabel":"number"},"message":{"type":"string","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.1.message","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.1.name","typeLabel":"string"},"finch_code":{"type":"string","uniqueKey":"responses.items.[INDEX].body.oneOf.1.finch_code","typeLabel":"string"}},"isRequired":true,"uniqueKey":"responses.items.[INDEX].body.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"responses.items.[INDEX].body","typeLabel":"EmploymentDataResponseBody · object | object"}},"required":["individual_id","code","body"],"uniqueKey":"responses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"responses","typeLabel":"object[]"}},"required":["responses"],"uniqueKey":"","typeLabel":"object"},"examples":{"Success":{"title":"Success","value":{"responses":[{"individual_id":"5d0b10a1-a09a-430f-81f1-20be735dc5e9","code":200,"body":{"id":"5d0b10a1-a09a-430f-81f1-20be735dc5e9","first_name":"Jane","middle_name":null,"last_name":"Doe","title":"Customer Support","manager":{"id":"c205b3fa-b626-4346-bf0f-ca065ab88d31"},"department":{"name":"Product"},"employment":{"type":"employee","subtype":"full_time"},"start_date":"2017-06-30","end_date":null,"latest_rehire_date":null,"is_active":true,"employment_status":"onboarding","flsa_status":"exempt","union_code":null,"union_local":null,"benefit_eligibility_class":null,"highly_compensated_employee":false,"key_employee":false,"class_code":"8810","location":{"line1":"12 Bird Drive","line2":null,"city":"Palo Alto","state":"CA","postal_code":"94301","country":"US"},"income":{"unit":"yearly","amount":10000000,"currency":"usd","effective_date":"2019-03-01"},"income_history":[{"unit":"yearly","amount":9000000,"currency":"usd","effective_date":"2018-05-15"},{"unit":"yearly","amount":8000000,"currency":"usd","effective_date":"2017-06-30"}],"custom_fields":[{"name":"tShirtSize","value":"L"}],"source_id":"VWK-88a8505d"}}]}},"BatchError":{"title":"BatchError","value":{"responses":[{"individual_id":"8b3f8edc-735d-4382-84d6-104eac2013b5","code":404,"body":{"code":404,"finch_code":"individual_not_found","message":"No individual with id 8b3f8edc-735d-4382-84d6-104eac2013b5 found","name":"not_found_error"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"c62b3ded-7171-4621-a05b-ba1c4abea463":{"description":"The request has been accepted for processing, but data is not yet available","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"finch_code":{"type":"string","isRequired":true,"uniqueKey":"finch_code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"number","default":202,"uniqueKey":"code","typeLabel":"number"}},"required":["name","finch_code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"DataSyncInProgress":{"title":"DataSyncInProgress","value":{"code":202,"name":"sync_in_progress","finch_code":"data_sync_in_progress","message":"The data being requested is being fetched. Please check back later."}},"AuthorizationPending":{"title":"AuthorizationPending","value":{"code":202,"name":"authorization_pending","finch_code":"pending","message":"Authorization to this company's data is pending"}},"AccountantSetupPending":{"title":"AccountantSetupPending","value":{"code":202,"name":"authorization_pending","finch_code":"accountant_setup_pending","message":"Finch is still setting up the accountant user for this connection. Please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"},"e3b72d4e-e004-405f-9cc4-7761ca473f26":{"description":"Bad Request","content":{"application/json":{"schema":{"title":"Error","type":"object","description":"Generic error response structure","properties":{"code":{"type":"integer","description":"The status code of the request.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"name":{"type":"string","description":"Identifier describing the error.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"finch_code":{"type":"string","description":"A descriptive identifier for the error.","isRequired":true,"uniqueKey":"finch_code","typeLabel":"string"},"message":{"type":"string","description":"A short English description that provides more information about the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","name","finch_code","message"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"MissingEntityIds":{"title":"MissingEntityIds","value":{"code":400,"name":"invalid_request_error","finch_code":"invalid_request","message":"Multi-entity connection requires entity_ids query parameter when multiple entities exist"}},"UnknownEntityId":{"title":"UnknownEntityId","value":{"code":400,"name":"invalid_request_error","finch_code":"invalid_request","message":"Provided entity_id 550e8400-e29b-41d4-a716-446655440000 does not match any connected entities"}},"InvalidEntityIds":{"title":"InvalidEntityIds","value":{"code":400,"name":"invalid_request_error","finch_code":"invalid_request","message":"Invalid query parameters for entity_ids"}}},"exampleType":"examples"}},"exampleType":"examples"},"4862495f-7f7c-4307-98ad-bec3d0fa7203":{"description":"The request could not be processed due to a validation error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"finch_code":{"type":"string","isRequired":true,"uniqueKey":"finch_code","typeLabel":"string"}},"required":["code","name","message","finch_code"],"uniqueKey":"","typeLabel":"object"},"examples":{"BatchLimitExceeded":{"title":"BatchLimitExceeded","value":{"code":422,"name":"unprocessable_entity_error","finch_code":"batch_limit_exceeded","message":"Batch size exceeds the maximum of 10000 items. Please reduce the number of items in your request."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6c86a1d1-7c0f-45e1-8fd2-d1dcc65828fe":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Please use your Access Token","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"c751b629-e47c-48d2-9131-f14412d7ead8":{"url":"https://api.tryfinch.com","description":""}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Please use your Access Token","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Please use your Access Token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"finch","siteName":"Finch","title":"Employment - Finch","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-09-15T15:44:25.911Z","originalFileLocation":"api-reference/organization/employment.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=\"Read individual employment and income data\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finch\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_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/finch/uhsSWlAJd6T26wSS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Employment - Finch\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read individual employment and income data\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finch\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.tryfinch.com/api-reference/organization/employment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://finch.mintlify.app/_mintlify/api/og/v2?division=Organization\u0026amp;title=Employment\u0026amp;description=Read+individual+employment+and+income+data\u0026amp;theme=833c5e58755e897492517fe7\u0026amp;signature=703b9b175d72054d5a6b9bda2b7cdf3bef92dfb91794775aefd42419a129b47a\">\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 - Finch\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read individual employment and income data\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://finch.mintlify.app/_mintlify/api/og/v2?division=Organization\u0026amp;title=Employment\u0026amp;description=Read+individual+employment+and+income+data\u0026amp;theme=833c5e58755e897492517fe7\u0026amp;signature=703b9b175d72054d5a6b9bda2b7cdf3bef92dfb91794775aefd42419a129b47a\">\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/finch/uhsSWlAJd6T26wSS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finch\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#161616\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.tryfinch.com/api-reference/organization/employment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/organization/employment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.tryfinch.com/#organization\",\"name\":\"Finch\",\"url\":\"https://developer.tryfinch.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/finch/ejF2Kw2CeeMQKCJw/logo/logo-black.svg?fit=max\u0026auto=format\u0026n=ejF2Kw2CeeMQKCJw\u0026q=85\u0026s=e490dba98fb7b16e8f9f5ab4a9a58a5c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.tryfinch.com#website\",\"name\":\"Finch\",\"url\":\"https://developer.tryfinch.com\",\"publisher\":{\"@id\":\"https://developer.tryfinch.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.tryfinch.com/api-reference/organization/employment#webpage\",\"url\":\"https://developer.tryfinch.com/api-reference/organization/employment\",\"name\":\"Employment\",\"description\":\"Read individual employment and income data\",\"dateModified\":\"2025-09-15T15:44:25.911Z\",\"isPartOf\":{\"@id\":\"https://developer.tryfinch.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.tryfinch.com/api-reference/organization/employment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.tryfinch.com/api-reference/organization/employment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organization\",\"item\":\"https://developer.tryfinch.com/api-reference/organization/company\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Employment\",\"item\":\"https://developer.tryfinch.com/api-reference/organization/employment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.tryfinch.com/api-reference/organization/employment#apireference\",\"headline\":\"Employment\",\"name\":\"Employment\",\"description\":\"Read individual employment and income data\",\"url\":\"https://developer.tryfinch.com/api-reference/organization/employment\",\"mainEntityOfPage\":{\"@id\":\"https://developer.tryfinch.com/api-reference/organization/employment#webpage\"},\"dateModified\":\"2025-09-15T15:44:25.911Z\",\"publisher\":{\"@id\":\"https://developer.tryfinch.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.tryfinch.com#website\"}}]}\u003c/script>","siteName":"Finch","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":{"style":"sharp-solid","name":"megaphone"},"color":{"light":"#3E4AE7","dark":"#3E4AE7"},"href":"https://developer.tryfinch.com/changelog"},{"anchor":"API Status","icon":{"style":"sharp-solid","name":"signal-bars"},"color":{"light":"#3E4AE7","dark":"#3E4AE7"},"href":"https://status.tryfinch.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/how-finch-works/quickstart"}]},{"tab":"API Reference","groups":[{"group":"Organization","pages":[{"openapi":"get /employer/company","title":"Company","href":"/api-reference/organization/company"},{"openapi":"get /employer/directory","title":"Directory","href":"/api-reference/organization/directory"},{"openapi":"post /employer/individual","title":"Individual","description":"Read individual data, excluding income and employment data","href":"/api-reference/organization/individual"},{"openapi":"post /employer/employment","title":"Employment","href":"/api-reference/organization/employment"}]},{"group":"Payroll","pages":[{"openapi":"get /employer/payment","title":"Payment","description":"Read payroll and contractor related payments by the company.","href":"/api-reference/payroll/payment"},{"openapi":"post /employer/pay-statement","title":"Pay Statement","href":"/api-reference/payroll/pay-statement"},{"openapi":"get /employer/pay-statement-item","title":"Pay Statement Item","href":"/api-reference/payroll/get-pay-statement-items"},{"group":"Rules","pages":[{"openapi":"post /employer/pay-statement-item/rule","title":"Create Rule","href":"/api-reference/payroll/create-rule"},{"openapi":"get /employer/pay-statement-item/rule","title":"Get Rules","href":"/api-reference/payroll/get-rules"},{"openapi":"put /employer/pay-statement-item/rule/{rule_id}","title":"Update Rule","href":"/api-reference/payroll/update-rule"},{"openapi":"delete /employer/pay-statement-item/rule/{rule_id}","title":"Delete Rule","href":"/api-reference/payroll/delete-rule"}]},{"openapi":"get /employer/pay-groups","title":"Get All Pay Groups","href":"/api-reference/payroll/get-pay-groups"},{"openapi":"get /employer/pay-groups/{pay_group_id}","title":"Get Pay Group","href":"/api-reference/payroll/get-pay-group"},{"openapi":"post /employer/ledger-items","title":"Ledger Items","href":"/api-reference/payroll/get-ledger-items"}]},{"group":"Deductions","pages":[{"openapi":"get /employer/benefits","title":"Get All Deductions","href":"/api-reference/deductions/get-all-deductions"},{"openapi":"post /employer/benefits/register","title":"Register Deduction","href":"/api-reference/deductions/register-deduction"},{"openapi":"post /employer/benefits","title":"Create Deduction","href":"/api-reference/deductions/create-deduction"},{"openapi":"get /employer/benefits/{benefit_id}","title":"Get Deduction","href":"/api-reference/deductions/get-deduction"},{"openapi":"post /employer/benefits/{benefit_id}","title":"Update Deduction","href":"/api-reference/deductions/update-deduction"},{"openapi":"get /employer/benefits/{benefit_id}/enrolled","title":"Get Enrolled Individuals","href":"/api-reference/deductions/get-enrolled-individuals"},{"openapi":"get /employer/benefits/{benefit_id}/individuals","title":"Get Deductions for Individuals","href":"/api-reference/deductions/get-deductions-for-individuals"},{"openapi":"post /employer/benefits/{benefit_id}/individuals","title":"Enroll Individuals in Deductions","href":"/api-reference/deductions/enroll-individuals-in-deductions"},{"openapi":"delete /employer/benefits/{benefit_id}/individuals","title":"Unenroll Individuals from Deductions","href":"/api-reference/deductions/unenroll-individuals-from-deductions"}]},{"group":"Benefits","pages":[{"openapi":"get /employer/plans","title":"List Plans","href":"/api-reference/benefits/list-plans"},{"openapi":"get /employer/plans/{plan_id}","title":"Get Plan","href":"/api-reference/benefits/get-plan"},{"openapi":"get /employer/plans-enrollments","title":"List Enrollments","href":"/api-reference/benefits/list-plan-enrollments"},{"openapi":"post /employer/plans-enrollments","title":"Get Enrollments","href":"/api-reference/benefits/get-plan-enrollments"},{"openapi":"get /employer/plans-dependents","title":"List Dependents","href":"/api-reference/benefits/list-plan-dependents"},{"openapi":"post /employer/plans-dependents","title":"Get Dependents","href":"/api-reference/benefits/get-plan-dependents"}]},{"group":"Documents","pages":[{"openapi":"get /employer/documents","title":"List Documents","href":"/api-reference/documents/get-documents"},{"openapi":"get /employer/documents/{document_id}","title":"Get Document","href":"/api-reference/documents/get-document"}]},{"group":"Connect","pages":[{"openapi":"post /connect/sessions","title":"Create a new connect session","href":"/api-reference/connect/new-session"},{"openapi":"post /connect/sessions/reauthenticate","title":"Create a new Connect session for reauthentication","href":"/api-reference/connect/reauthenticate-session"}]},{"group":"Management","pages":[{"openapi":"post /auth/token","title":"Create Access Token","href":"/api-reference/management/create-access-token"},{"openapi":"get /providers","title":"Providers","href":"/api-reference/management/providers"},{"openapi":"get /introspect","title":"Introspect","href":"/api-reference/management/introspect"},{"openapi":"post /disconnect","title":"Disconnect","href":"/api-reference/management/disconnect"},{"openapi":"post /disconnect-entity","title":"Disconnect Entity","href":"/api-reference/management/disconnect-entity"},{"openapi":"post /forward","title":"Request Forwarding","href":"/api-reference/management/request-forwarding"},{"openapi":"get /jobs/automated","title":"List All Automated Jobs","href":"/api-reference/management/list-all-automated-jobs"},{"openapi":"post /jobs/automated","title":"Enqueue a New Automated Job","href":"/api-reference/management/enqueue-a-new-automated-job"},{"openapi":"get /jobs/automated/{job_id}","title":"Retrieve an Automated Job","href":"/api-reference/management/retrieve-an-automated-job"},{"openapi":"get /jobs/manual/{job_id}","title":"Retrieve a Manual Job","href":"/api-reference/management/retrieve-a-manual-job"}]},{"group":"Sandbox","pages":[{"openapi":"post /sandbox/connections","title":"Create a new Sandbox Connection","href":"/api-reference/sandbox/create-sandbox-connection"},{"openapi":"post /sandbox/connections/accounts","title":"Create a new sandbox account","href":"/api-reference/sandbox/create-sandbox-account"},{"openapi":"put /sandbox/connections/accounts","title":"Update a sandbox account","href":"/api-reference/sandbox/update-sandbox-account"},{"openapi":"get /sandbox/jobs/configuration","title":"Get configurations for sandbox jobs","href":"/api-reference/sandbox/get-sandbox-jobs-configuration"},{"openapi":"put /sandbox/jobs/configuration","title":"Update configurations for sandbox jobs","href":"/api-reference/sandbox/update-sandbox-jobs-configuration"},{"openapi":"post /sandbox/payment","title":"Add a new sandbox payment","href":"/api-reference/sandbox/create-sandbox-payment"},{"openapi":"put /sandbox/individual/{individual_id}","title":"Update sandbox individual","href":"/api-reference/sandbox/update-sandbox-individual"},{"openapi":"put /sandbox/employment/{individual_id}","title":"Update sandbox employment","href":"/api-reference/sandbox/update-sandbox-employment"},{"openapi":"post /sandbox/directory","title":"Add new individuals to a sandbox company","href":"/api-reference/sandbox/create-sandbox-employee"},{"openapi":"put /sandbox/company","title":"Update a sandbox company's data","href":"/api-reference/sandbox/update-sandbox-company"},{"openapi":"post /sandbox/jobs","title":"Enqueue a new sandbox job","href":"/api-reference/sandbox/refresh-job"}]},{"group":"Development Guides","pages":[{"title":"Permissions","href":"/api-reference/development-guides/Permissions"},{"title":"Headers","href":"/api-reference/development-guides/Headers"},{"title":"API Versioning","href":"/api-reference/development-guides/Versioning"},{"title":"Rate Limits","href":"/api-reference/development-guides/Rate-Limits"},{"title":"Handling API Responses","href":"/api-reference/development-guides/Handling-API-Responses"},{"group":"Errors","pages":[{"title":"Error Handling","href":"/api-reference/development-guides/errors/Error-Handling"},{"title":"Error Types","href":"/api-reference/development-guides/errors/Error-Types"}]}]}]}]},"title":"Employment - Finch","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}