Learn what taxonomies are and how to list available values for extension properties.
What Are Taxonomies?
A taxonomy is a named list of values that can be used by extension properties (category: extension on their employee-attribute-definition). Think of it as a configurable picklist: “T-shirt sizes”, “Office locations”, etc.Each individual entry in a taxonomy is called a taxonomy-label (e.g. “Small”, “Medium”, “Large” within a “T-shirt sizes” taxonomy).When an extension property is of type taxonomy-label-reference, its value must be one of the labels belonging to a specific taxonomy.
Common Use Case: Listing Available Values for an Extension Employee Attribute
When reading employee attributes, you may encounter a definition whose schema is taxonomy-label-reference:
Use isArchived=false to exclude deprecated values that are no longer selectable.
Required Scope
Reading taxonomies and taxonomy-labels requires the taxonomies.readonly scope (or taxonomies.readwrite).
Filtering and Sorting Taxonomy-Labels
Parameter
Description
taxonomy.id
Filter labels by taxonomy (required in most use cases).
isArchived
Filter by archival status (true, false).
search
Find labels whose name starts with the given string.
sort
Sort by id, name, or createdAt (prefix with - to reverse).
Summary
Step
Action
1
Read the employee-attribute-definition to find taxonomy.id
2
Call GET /lucca-api/taxonomy-labels?taxonomy.id={id} to list available values
3
Use the label id when writing an employee-attribute value
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Lucca API","colors":{"primary":"#C75000","light":"#FF7B3D","dark":"#E65A14"},"logo":{"light":"https://mintcdn.com/lucca/6CPlsApetP0UYjIR/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=6CPlsApetP0UYjIR\u0026q=85\u0026s=af3853ae211129c5d4a0bbac9a42e3f4","dark":"https://mintcdn.com/lucca/6CPlsApetP0UYjIR/assets/logo/dark.svg?fit=max\u0026auto=format\u0026n=6CPlsApetP0UYjIR\u0026q=85\u0026s=be0b4c98dd48054847469d5a5302e530"},"favicon":"https://mintcdn.com/lucca/6CPlsApetP0UYjIR/assets/favicon.svg?fit=max\u0026auto=format\u0026n=6CPlsApetP0UYjIR\u0026q=85\u0026s=ab4de94a9c9570834b3dbbfc86764629","api":{"openapi":["openapi-specs/authentication.yaml","openapi-specs/webhook-client-api.json"],"playground":{"display":"interactive"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#030A1A"}},"navbar":{"links":[],"primary":{"type":"button","label":"Sign in","href":"https://www.lucca.fr/login/"}},"footer":{"socials":{"x":"https://twitter.com/LuccaSoftware","github":"https://github.com/LuccaSA","linkedin":"https://www.linkedin.com/company/lucca"},"links":[{"header":"Resources","items":[{"label":"Lucca API","href":"https://developers.lucca.fr/documentation/get-started/introduction"},{"label":"Legacy API","href":"https://developers.lucca.fr/legacy/api-reference"}]},{"header":"Company","items":[{"label":"lucca.fr","href":"https://www.lucca.fr"},{"label":"Careers","href":"https://jobs.luccasoftware.com"},{"label":"Blog","href":"https://www.lucca.fr/actualites"}]}]},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/luccaapicommunity/shared_invite/zt-32njiaefl-QjdcZ8JGfPEO_y6BdJh3lg"},{"anchor":"Status","icon":"signal-strong","href":"https://status.lucca.fr"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lucca","hasAudioNarration":false,"actualSubdomain":"lucca","customDomains":["developers.luccasoftware.com"],"gitSource":{"type":"github","owner":"luccasa","repo":"lucca.publicapi","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b00062813ff8a81a62cbc9c","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":380},{"language":"default","tag":"Employee Records","count":60},{"language":"default","tag":"Invoices API","count":45},{"language":"default","tag":"Timesheet API","count":36},{"language":"default","tag":"Documentation","count":33},{"language":"default","tag":"Guides","count":29},{"language":"default","tag":"Organization","count":27},{"language":"default","tag":"Absences API","count":23},{"language":"default","tag":"Organization Structure API","count":22},{"language":"default","tag":"Compensation API","count":21}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"assets/styles.css","content":".hero-block-illustration{flex:1 1 15%;position:relative;overflow:visible}.hero-block-illustration span{position:initial}.hero-block-illustration img{position:absolute;max-width:1000px;height:auto;width:auto;top:-10rem;cursor:pointer;pointer-events:none}.hero-block-illustration img:is(.dark *){opacity:0.5}.hero-block-illustration.left img{right:0}.hero-block-illustration.right img{left:0}.hero-block-content{flex:0 1 50%;display:flex;flex-direction:column;align-items:center;justify-items:center}@media (max-width: 1024px){#lucca-home-container{padding-top:8rem}.hero-block-illustration{display:none}.hero-block-content{flex:1 1 100%}}.changelog-item .main-illustration img{margin:0}ul.oauth-scopes,ul.oauth-scopes ul{margin:0!important}ul.oauth-scopes strong{display:block}ul.oauth-scopes.single-li{padding-left:0.5rem}ul.oauth-scopes.single-li,ul.oauth-scopes.single-li ul,ul.oauth-scopes.single-li li{display:inline}ul.oauth-scopes.single-li>li{padding:0!important}ul.oauth-scopes.single-li>li::before{display:none}ul.oauth-scopes li{margin:0!important}ul.oauth-scopes ul{display:inline-block}ul.oauth-scopes ul li::before{display:none}ul.oauth-scopes>li{display:block}ul.oauth-scopes>li:not(:last-child)::after{display:block;content:\"or\";padding:0 0.5rem;margin:0.5rem 0}ul.oauth-scopes ul li{display:inline-block;padding:0!important}ul.oauth-scopes ul li:not(:last-child)::after{display:inline-block;content:\"and\";padding:0 0.5rem}"}]}
{"page":{"pagePath":"api-reference/latest/taxonomies/get-started","slug":"/api-reference/latest/taxonomies/get-started","pageMetadata":{"title":"Get Started With Taxonomies","sidebarTitle":"Get Started","description":"Learn what taxonomies are and how to list available values for extension properties.","href":"/api-reference/latest/taxonomies/get-started"},"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: \"Learn what taxonomies are and how to list available values for extension properties.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`what-are-taxonomies`,children:`What Are Taxonomies?`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`taxonomy`}),` is a named list of values that can be used by extension properties (`,_jsx(_components.code,{children:`category: extension`}),` on their `,_jsx(_components.a,{href:`/api-reference/latest/employee-attributes/employee-attribute-definition`,children:`employee-attribute-definition`}),`). Think of it as a configurable picklist: “T-shirt sizes”, “Office locations”, etc.`]}),`\n`,_jsxs(_components.p,{children:[`Each individual entry in a taxonomy is called a `,_jsx(_components.strong,{children:`taxonomy-label`}),` (e.g. “Small”, “Medium”, “Large” within a “T-shirt sizes” taxonomy).`]}),`\n`,_jsxs(_components.p,{children:[`When an extension property is of type `,_jsx(_components.code,{children:`taxonomy-label-reference`}),`, its value must be one of the labels belonging to a specific taxonomy.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`common-use-case-listing-available-values-for-an-extension-employee-attribute`,children:`Common Use Case: Listing Available Values for an Extension Employee Attribute`}),`\n`,_jsxs(_components.p,{children:[`When reading employee attributes, you may encounter a definition whose schema is `,_jsx(_components.code,{children:`taxonomy-label-reference`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e_tShirtSize\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"T-shirt size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"schema\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"$id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/lucca-api/schemas/taxonomy-label-reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:` ...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"45\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.ilucca.net/lucca-api/taxonomies/45\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`taxonomy.id`}),` field tells you which taxonomy holds the allowed values. To retrieve them, call:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /lucca-api/taxonomy-labels?taxonomy.id=45\u0026limit=100 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Host`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` example.ilucca.net`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer {ACCESS_TOKEN}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Api-Version`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 2024-11-01`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Accept`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The response lists all labels in that taxonomy:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`28`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`28`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"101\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy-label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.ilucca.net/lucca-api/taxonomy-labels/101\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Small\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"45\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isArchived\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"102\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy-label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.ilucca.net/lucca-api/taxonomy-labels/102\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Medium\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"45\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isArchived\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"103\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy-label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.ilucca.net/lucca-api/taxonomy-labels/103\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Large\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"45\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"taxonomy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isArchived\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Tip,{children:[`Use `,_jsx(_components.code,{children:`isArchived=false`}),` to exclude deprecated values that are no longer selectable.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`required-scope`,children:`Required Scope`}),`\n`,_jsxs(_components.p,{children:[`Reading taxonomies and taxonomy-labels requires the `,_jsx(_components.code,{children:`taxonomies.readonly`}),` scope (or `,_jsx(_components.code,{children:`taxonomies.readwrite`}),`).`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`filtering-and-sorting-taxonomy-labels`,children:`Filtering and Sorting Taxonomy-Labels`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Parameter`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`taxonomy.id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Filter labels by taxonomy (required in most use cases).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`isArchived`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Filter by archival status (`,_jsx(_components.code,{children:`true`}),`, `,_jsx(_components.code,{children:`false`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`search`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Find labels whose name starts with the given string.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`sort`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Sort by `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, or `,_jsx(_components.code,{children:`createdAt`}),` (prefix with `,_jsx(_components.code,{children:`-`}),` to reverse).`]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`summary`,children:`Summary`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Step`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`1`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Read the employee-attribute-definition to find `,_jsx(_components.code,{children:`taxonomy.id`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`2`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Call `,_jsx(_components.code,{children:`GET /lucca-api/taxonomy-labels?taxonomy.id={id}`}),` to list available values`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`3`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Use the label `,_jsx(_components.code,{children:`id`}),` when writing an employee-attribute value`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Started With Taxonomies","sidebarTitle":"Get Started","description":"Learn what taxonomies are and how to list available values for extension properties.","href":"/api-reference/latest/taxonomies/get-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What Are Taxonomies?","slug":"what-are-taxonomies","depth":2,"children":[]},{"title":"Common Use Case: Listing Available Values for an Extension Employee Attribute","slug":"common-use-case-listing-available-values-for-an-extension-employee-attribute","depth":2,"children":[]},{"title":"Required Scope","slug":"required-scope","depth":2,"children":[]},{"title":"Filtering and Sorting Taxonomy-Labels","slug":"filtering-and-sorting-taxonomy-labels","depth":2,"children":[]},{"title":"Summary","slug":"summary","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"lucca","siteName":"Lucca API","title":"Get Started With Taxonomies - Lucca API","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{"V5 (latest)":{"href":"/api-reference/latest/taxonomies/get-started","matchLevel":0},"V3 \u0026 V4 (legacy)":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T13:51:28.904Z","originalFileLocation":"api-reference/latest/taxonomies/get-started.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=\"dark\"}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=\"Learn what taxonomies are and how to list available values for extension properties.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lucca API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_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/lucca/WGD-jBwMyT2ahweA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Started With Taxonomies - Lucca API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn what taxonomies are and how to list available values for extension properties.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lucca API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lucca.mintlify.site/_mintlify/api/og/v2?division=Taxonomies\u0026amp;title=Get+Started+With+Taxonomies\u0026amp;description=Learn+what+taxonomies+are+and+how+to+list+available+values+for+extension+properties.\u0026amp;theme=78529ce9555b182511a1fe1d\u0026amp;signature=62d719eefea403c1c0b6396b9fb0bdbbfadcebc14a705032a62057aebcd5c957\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Started With Taxonomies - Lucca API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn what taxonomies are and how to list available values for extension properties.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lucca.mintlify.site/_mintlify/api/og/v2?division=Taxonomies\u0026amp;title=Get+Started+With+Taxonomies\u0026amp;description=Learn+what+taxonomies+are+and+how+to+list+available+values+for+extension+properties.\u0026amp;theme=78529ce9555b182511a1fe1d\u0026amp;signature=62d719eefea403c1c0b6396b9fb0bdbbfadcebc14a705032a62057aebcd5c957\">\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/lucca/WGD-jBwMyT2ahweA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lucca API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C75000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/latest/taxonomies/get-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.luccasoftware.com/#organization\",\"name\":\"Lucca API\",\"url\":\"https://developers.luccasoftware.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lucca/6CPlsApetP0UYjIR/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=6CPlsApetP0UYjIR\u0026q=85\u0026s=af3853ae211129c5d4a0bbac9a42e3f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.luccasoftware.com#website\",\"name\":\"Lucca API\",\"url\":\"https://developers.luccasoftware.com\",\"publisher\":{\"@id\":\"https://developers.luccasoftware.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started#webpage\",\"url\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started\",\"name\":\"Get Started With Taxonomies\",\"description\":\"Learn what taxonomies are and how to list available values for extension properties.\",\"dateModified\":\"2026-11-13T13:51:28.904Z\",\"isPartOf\":{\"@id\":\"https://developers.luccasoftware.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organization\",\"item\":\"https://developers.luccasoftware.com/api-reference/latest/organization/get-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Started With Taxonomies\",\"item\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started#article\",\"headline\":\"Get Started With Taxonomies\",\"name\":\"Get Started With Taxonomies\",\"description\":\"Learn what taxonomies are and how to list available values for extension properties.\",\"url\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started\",\"mainEntityOfPage\":{\"@id\":\"https://developers.luccasoftware.com/api-reference/latest/taxonomies/get-started#webpage\"},\"dateModified\":\"2026-11-13T13:51:28.904Z\",\"publisher\":{\"@id\":\"https://developers.luccasoftware.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.luccasoftware.com#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/latest/taxonomies/get-started.md","siteName":"Lucca API","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/luccaapicommunity/shared_invite/zt-32njiaefl-QjdcZ8JGfPEO_y6BdJh3lg"},{"anchor":"Status","icon":"signal-strong","href":"https://status.lucca.fr"}]},"versions":[{"version":"V5 (latest)","tag":"2024-11-01","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/home"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/get-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"The Lucca API","sidebarTitle":"Introduction","href":"/api-reference/latest/introduction"},{"openapi":"authentication POST /connect/token","title":"Create Access-Token","href":"/api-reference/latest/create-access-token"},{"title":"OAuth scopes","sidebarTitle":"OAuth scopes","mode":"wide","href":"/api-reference/latest/oauth-scopes"},{"title":"API lifecycle","sidebarTitle":"API lifecycle","mode":"wide","href":"/api-reference/latest/lifecycle"},{"title":"Download the OpenAPI specification","sidebarTitle":"OpenAPI.json","href":"/api-reference/latest/download"}]},{"group":"Files","pages":[{"title":"Get Started","href":"/api-reference/latest/files/get-started"},{"title":"The file resource","href":"/api-reference/latest/files/file"},{"title":"Upload a file","deprecated":null,"version":null,"sidebarTitle":"Upload a file","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/files","href":"/api-reference/latest/files/post-files"},{"title":"Retrieve a file","deprecated":null,"version":null,"sidebarTitle":"Retrieve a file","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/files/{id}","href":"/api-reference/latest/files/get-file"}]},{"group":"Organization","pages":[{"title":"Get Started","mode":"wide","href":"/api-reference/latest/organization/get-started"},{"group":"Legal-entities","pages":[{"title":"The legal-entity resource","href":"/api-reference/latest/organization/legal-entity"},{"title":"List legal-entities","deprecated":null,"version":null,"sidebarTitle":"List legal-entities","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/legal-entities","href":"/api-reference/latest/organization/get-legal-entities"},{"title":"Retrieve a legal-entity","deprecated":null,"version":null,"sidebarTitle":"Retrieve a legal-entity","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/legal-entities/{id}","href":"/api-reference/latest/organization/get-legal-entity"}]},{"group":"Business-establishments","pages":[{"title":"The business-establishment resource","href":"/api-reference/latest/organization/business-establishment"},{"title":"List business-establishments","deprecated":null,"version":null,"sidebarTitle":"List business-establishments","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/business-establishments","href":"/api-reference/latest/organization/list-business-establishments"},{"title":"Retrieve a business-establishment","deprecated":null,"version":null,"sidebarTitle":"Retrieve a business-establishment","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/business-establishments/{id}","href":"/api-reference/latest/organization/get-business-establishment"}]},{"group":"Departments","pages":[{"title":"The department resource","href":"/api-reference/latest/organization/department"},{"title":"List departments","deprecated":null,"version":null,"sidebarTitle":"List departments","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/departments","href":"/api-reference/latest/organization/get-departments"},{"title":"Create a department","deprecated":null,"version":null,"sidebarTitle":"Create a department","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/departments","href":"/api-reference/latest/organization/post-departments"},{"title":"Retrieve a department","deprecated":null,"version":null,"sidebarTitle":"Retrieve a department","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/departments/{id}","href":"/api-reference/latest/organization/get-department"},{"title":"Update a department","description":"Update a department.","deprecated":null,"version":null,"sidebarTitle":"Update a department","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/departments/{id}","href":"/api-reference/latest/organization/patch-department"}]},{"group":"Taxonomies","pages":[{"title":"Get Started With Taxonomies","sidebarTitle":"Get Started","href":"/api-reference/latest/taxonomies/get-started"},{"title":"The taxonomy resource","description":null,"href":"/api-reference/latest/taxonomies/taxonomy"},{"title":"List taxonomies","deprecated":null,"version":null,"sidebarTitle":"List taxonomies","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/taxonomies","href":"/api-reference/latest/taxonomies/get-taxonomies"},{"title":"Create a taxonomy","deprecated":null,"version":null,"sidebarTitle":"Create a taxonomy","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/taxonomies","href":"/api-reference/latest/taxonomies/post-taxonomy"},{"title":"Retrieve a taxonomy","deprecated":null,"version":null,"sidebarTitle":"Retrieve a taxonomy","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/taxonomies/{id}","href":"/api-reference/latest/taxonomies/get-taxonomy"},{"title":"Replace a taxonomy","deprecated":null,"version":null,"sidebarTitle":"Replace a taxonomy","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json put /lucca-api/taxonomies/{id}","href":"/api-reference/latest/taxonomies/put-taxonomy"},{"title":"Update a taxonomy","deprecated":null,"version":null,"sidebarTitle":"Update a taxonomy","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/taxonomies/{id}","href":"/api-reference/latest/taxonomies/patch-taxonomy"},{"title":"Delete a taxonomy","deprecated":null,"version":null,"sidebarTitle":"Delete a taxonomy","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/taxonomies/{id}","href":"/api-reference/latest/taxonomies/delete-taxonomy"},{"title":"The taxonomy-label resource","href":"/api-reference/latest/taxonomies/taxonomy-label"},{"title":"List taxonomy-labels","deprecated":null,"version":null,"sidebarTitle":"List taxonomy-labels","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/taxonomy-labels","href":"/api-reference/latest/taxonomies/get-taxonomy-labels"},{"title":"Create a taxonomy-label","deprecated":null,"version":null,"sidebarTitle":"Create a taxonomy-label","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/taxonomy-labels","href":"/api-reference/latest/taxonomies/post-taxonomy-label"},{"title":"Retrieve a taxonomy-label","deprecated":null,"version":null,"sidebarTitle":"Retrieve a taxonomy-label","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/taxonomy-labels/{id}","href":"/api-reference/latest/taxonomies/get-taxonomy-label"},{"title":"Replace a taxonomy-label","deprecated":null,"version":null,"sidebarTitle":"Replace a taxonomy-label","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json put /lucca-api/taxonomy-labels/{id}","href":"/api-reference/latest/taxonomies/put-taxonomy-label"},{"title":"Update a taxonomy-label","deprecated":null,"version":null,"sidebarTitle":"Update a taxonomy-label","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/taxonomy-labels/{id}","href":"/api-reference/latest/taxonomies/patch-taxonomy-label"},{"title":"Delete a taxonomy-label","deprecated":null,"version":null,"sidebarTitle":"Delete a taxonomy-label","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/taxonomy-labels/{id}","href":"/api-reference/latest/taxonomies/delete-taxonomy-label"}]}]},{"group":"Employee Records","pages":[{"sidebarTitle":"Get Started","title":"Get Started With Employees","href":"/api-reference/latest/employees/get-started"},{"group":"Employee Attributes","pages":[{"title":"Get Started With Employee Attributes","sidebarTitle":"Get Started","href":"/api-reference/latest/employee-attributes/get-started"},{"title":"The employee-attribute-definition resource","href":"/api-reference/latest/employee-attributes/employee-attribute-definition"},{"title":"List employee-attribute-definitions","deprecated":null,"version":null,"sidebarTitle":"List employee-attribute-definitions","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-attribute-definitions","href":"/api-reference/latest/employee-attributes/get-employee-attribute-definitions"},{"title":"Create an employee-attribute-definition","deprecated":null,"version":null,"sidebarTitle":"Create an employee-attribute-definition","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/employee-attribute-definitions","href":"/api-reference/latest/employee-attributes/post-employee-attribute-definition"},{"title":"Retrieve an employee-attribute-definition","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employee-attribute-definition","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-attribute-definitions/{id}","href":"/api-reference/latest/employee-attributes/get-employee-attribute-definition"},{"title":"Replace an employee-attribute-definition","deprecated":null,"version":null,"sidebarTitle":"Replace an employee-attribute-definition","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json put /lucca-api/employee-attribute-definitions/{id}","href":"/api-reference/latest/employee-attributes/put-employee-attribute-definition"},{"title":"Update an employee-attribute-definition","deprecated":null,"version":null,"sidebarTitle":"Update an employee-attribute-definition","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/employee-attribute-definitions/{id}","href":"/api-reference/latest/employee-attributes/patch-employee-attribute-definition"},{"title":"Delete an employee-attribute-definition","deprecated":null,"version":null,"sidebarTitle":"Delete an employee-attribute-definition","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/employee-attribute-definitions/{id}","href":"/api-reference/latest/employee-attributes/delete-employee-attribute-definition"},{"title":"Employee Attribute Definition Schemas","sidebarTitle":"Definition Schemas","href":"/api-reference/latest/employee-attributes/attribute-definition-schemas"},{"title":"The employee-attribute resource","href":"/api-reference/latest/employee-attributes/employee-attribute"},{"title":"List employee-attributes","deprecated":null,"version":null,"sidebarTitle":"List employee-attributes","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-attributes","href":"/api-reference/latest/employee-attributes/get-employee-attributes"},{"title":"Create an employee-attribute","deprecated":null,"version":null,"sidebarTitle":"Create an employee-attribute","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/employee-attributes","href":"/api-reference/latest/employee-attributes/post-employee-attribute"},{"title":"Retrieve an employee-attribute","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employee-attribute","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-attributes/{id}","href":"/api-reference/latest/employee-attributes/get-employee-attribute"},{"title":"Replace an employee-attribute","deprecated":null,"version":null,"sidebarTitle":"Replace an employee-attribute","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json put /lucca-api/employee-attributes/{id}","href":"/api-reference/latest/employee-attributes/put-employee-attribute"},{"title":"Update an employee-attribute","deprecated":null,"version":null,"sidebarTitle":"Update an employee-attribute","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/employee-attributes/{id}","href":"/api-reference/latest/employee-attributes/patch-employee-attribute"},{"title":"Delete an employee-attribute","deprecated":null,"version":null,"sidebarTitle":"Delete an employee-attribute","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/employee-attributes/{id}","href":"/api-reference/latest/employee-attributes/delete-employee-attribute"}]},{"group":"Employees","pages":[{"title":"The employee resource","href":"/api-reference/latest/employees/employee"},{"title":"List employees","deprecated":null,"version":null,"sidebarTitle":"List employees","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employees","href":"/api-reference/latest/employees/get-employees"},{"title":"Create an employee","deprecated":null,"version":null,"sidebarTitle":"Create an employee","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/employees","href":"/api-reference/latest/employees/post-employees"},{"title":"Retrieve an employee","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employee","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employees/{id}","href":"/api-reference/latest/employees/get-employee"},{"title":"Update an employee","deprecated":null,"version":null,"sidebarTitle":"Update an employee","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/employees/{id}","href":"/api-reference/latest/employees/patch-employee"},{"title":"The portrait resource","href":"/api-reference/latest/employees/portrait"},{"title":"Retrieve/Download a portrait","deprecated":true,"version":null,"sidebarTitle":"Retrieve/Download a portrait","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/portraits/{id}","href":"/api-reference/latest/employees/get-portrait"}]},{"group":"Personal Records","pages":[{"title":"The employee-personal-record resource","href":"/api-reference/latest/employees/employee-personal-record"},{"title":"List employee-personal-records","deprecated":null,"version":null,"sidebarTitle":"List employee-personal-records","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-personal-records","href":"/api-reference/latest/employees/get-employee-personal-records"},{"title":"Retrieve an employee-personal-record","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employee-personal-record","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employee-personal-records/{id}","href":"/api-reference/latest/employees/get-employee-personal-record"},{"title":"Update employee-personal-record","deprecated":null,"version":null,"sidebarTitle":"Update employee-personal-record","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/employee-personal-records/{id}","href":"/api-reference/latest/employees/patch-employee-personal-record"}]},{"group":"Employments","pages":[{"title":"The employment resource","href":"/api-reference/latest/employments/employment"},{"title":"List employments","deprecated":null,"version":null,"sidebarTitle":"List employments","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employments","href":"/api-reference/latest/employments/get-employments"},{"title":"Create an employment","deprecated":null,"version":null,"sidebarTitle":"Create an employment","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/employments","href":"/api-reference/latest/employments/post-employments"},{"title":"Retrieve an employment","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employment","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employments/{id}","href":"/api-reference/latest/employments/get-employment"},{"title":"Update an employment","deprecated":null,"version":null,"sidebarTitle":"Update an employment","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/employments/{id}","href":"/api-reference/latest/employments/patch-employment"},{"title":"Delete an employment","deprecated":null,"version":null,"sidebarTitle":"Delete an employment","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/employments/{id}","href":"/api-reference/latest/employments/delete-employment"},{"title":"The employment-template resource","href":"/api-reference/latest/employments/employment-template"},{"title":"List employment-templates","deprecated":null,"version":null,"sidebarTitle":"List employment-templates","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employment-templates","href":"/api-reference/latest/employments/get-employment-templates"},{"title":"Retrieve an employment-template","deprecated":null,"version":null,"sidebarTitle":"Retrieve an employment-template","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/employment-templates/{id}","href":"/api-reference/latest/employments/get-employment-template"}]},{"group":"Job Positions","pages":[{"title":"The job-position resource","href":"/api-reference/latest/employments/job-position"},{"title":"List job-positions","deprecated":null,"version":null,"sidebarTitle":"List job-positions","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/job-positions","href":"/api-reference/latest/employments/get-job-positions"},{"title":"Create a job-position","deprecated":null,"version":null,"sidebarTitle":"Create a job-position","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/job-positions","href":"/api-reference/latest/employments/post-job-positions"},{"title":"Retrieve a job-position","deprecated":null,"version":null,"sidebarTitle":"Retrieve a job-position","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/job-positions/{id}","href":"/api-reference/latest/employments/get-job-position"},{"title":"Update a job-position","deprecated":null,"version":null,"sidebarTitle":"Update a job-position","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/job-positions/{id}","href":"/api-reference/latest/employments/patch-job-position"},{"title":"Delete a job-position","deprecated":null,"version":null,"sidebarTitle":"Delete a job-position","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/job-positions/{id}","href":"/api-reference/latest/employments/delete-job-position"}]},{"group":"Probationary Periods","pages":[{"title":"The probationary-period resource","href":"/api-reference/latest/employments/probationary-period"},{"title":"List probationary-periods","deprecated":null,"version":null,"sidebarTitle":"List probationary-periods","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/probationary-periods","href":"/api-reference/latest/employments/get-probationary-periods"},{"title":"Create a probationary-period","deprecated":null,"version":null,"sidebarTitle":"Create a probationary-period","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/probationary-periods","href":"/api-reference/latest/employments/post-probationary-period"},{"title":"Retrieve a probationary-period","deprecated":null,"version":null,"sidebarTitle":"Retrieve a probationary-period","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/probationary-periods/{id}","href":"/api-reference/latest/employments/get-probationary-period"},{"title":"Update a probationary-period","deprecated":null,"version":null,"sidebarTitle":"Update a probationary-period","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/probationary-periods/{id}","href":"/api-reference/latest/employments/put-probationary-period"},{"title":"Delete a probationary-period","deprecated":null,"version":null,"sidebarTitle":"Delete a probationary-period","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/probationary-periods/{id}","href":"/api-reference/latest/employments/delete-probationary-period"}]},{"group":"Occupation Categories","pages":[{"title":"Get Started","href":"/api-reference/latest/employee-occupation-categories/get-started"},{"title":"The occupation-category resource","href":"/api-reference/latest/employee-occupation-categories/occupation-category"},{"title":"List occupation-categories","deprecated":null,"version":null,"sidebarTitle":"List occupation-categories","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/occupation-categories","href":"/api-reference/latest/employee-occupation-categories/get-occupation-categories"},{"title":"Retrieve an occupation-category","deprecated":null,"version":null,"sidebarTitle":"Retrieve an occupation-category","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/occupation-categories/{id}","href":"/api-reference/latest/employee-occupation-categories/get-occupation-category"}]},{"group":"Job Qualifications","pages":[{"title":"Get Started","href":"/api-reference/latest/employee-job-qualifications/get-started"},{"title":"The profession resource","href":"/api-reference/latest/employee-job-qualifications/profession"},{"title":"List professions","deprecated":null,"version":null,"sidebarTitle":"List professions","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/professions","href":"/api-reference/latest/employee-job-qualifications/get-professions"},{"title":"Retrieve a profession","deprecated":null,"version":null,"sidebarTitle":"Retrieve a profession","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/professions/{id}","href":"/api-reference/latest/employee-job-qualifications/get-profession"},{"title":"The job-qualification resource","href":"/api-reference/latest/employee-job-qualifications/job-qualification"},{"title":"List job-qualifications","deprecated":null,"version":null,"sidebarTitle":"List job-qualifications","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/job-qualifications","href":"/api-reference/latest/employee-job-qualifications/get-job-qualifications"},{"title":"Retrieve a job-qualification","deprecated":null,"version":null,"sidebarTitle":"Retrieve a job-qualification","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/job-qualifications/{id}","href":"/api-reference/latest/employee-job-qualifications/get-job-qualification"}]}]},{"group":"Time Management","pages":[{"group":"Working-Time-Arrangements","pages":[{"title":"The working-time-arrangement resource","href":"/api-reference/latest/working-time-arrangements/working-time-arrangement"},{"title":"List working-time-arrangements","deprecated":null,"version":null,"sidebarTitle":"List working-time-arrangements","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/working-time-arrangements","href":"/api-reference/latest/working-time-arrangements/get-working-time-arrangements"},{"title":"Retrieve a working-time-arrangement","deprecated":null,"version":null,"sidebarTitle":"Retrieve a working-time-arrangement","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/working-time-arrangements/{id}","href":"/api-reference/latest/working-time-arrangements/get-working-time-arrangement"}]}]},{"group":"Events \u0026 Webhooks","pages":[{"title":"Get Started","href":"/api-reference/latest/events/get-started"},{"title":"Types of events","mode":"wide","href":"/api-reference/latest/events/event-topics"},{"title":"Access Control","href":"/api-reference/latest/events/access-control"},{"group":"Events","pages":[{"title":"The event resource","href":"/api-reference/latest/events/event"},{"title":"List events","deprecated":null,"version":null,"sidebarTitle":"List events","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/events","href":"/api-reference/latest/events/get-events"},{"title":"Retrieve an event","deprecated":null,"version":null,"sidebarTitle":"Retrieve an event","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/events/{id}","href":"/api-reference/latest/events/get-event"},{"title":"Test event (test.created)","href":"/api-reference/latest/events/test-event"}]},{"group":"Webhooks","pages":[{"title":"The webhook-endpoint resource","href":"/api-reference/latest/webhooks/webhook-endpoint"},{"title":"List webhook-endpoints","deprecated":null,"version":null,"sidebarTitle":"List webhook-endpoints","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-endpoints","href":"/api-reference/latest/webhooks/get-webhook-endpoints"},{"title":"Create a webhook-endpoint","deprecated":null,"version":null,"sidebarTitle":"Create a webhook-endpoint","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/webhook-endpoints","href":"/api-reference/latest/webhooks/post-webhook-endpoints"},{"title":"Retrieve a webhook-endpoint","deprecated":null,"version":null,"sidebarTitle":"Retrieve a webhook-endpoint","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-endpoints/{id}","href":"/api-reference/latest/webhooks/get-webhook-endpoint"},{"title":"Update a webhook-endpoint","deprecated":null,"version":null,"sidebarTitle":"Update a webhook-endpoint","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json patch /lucca-api/webhook-endpoints/{id}","href":"/api-reference/latest/webhooks/patch-webhook-endpoint"},{"title":"Delete a webhook-endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete a webhook-endpoint","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json delete /lucca-api/webhook-endpoints/{id}","href":"/api-reference/latest/webhooks/delete-webhook-endpoint"},{"title":"The webhook-delivery resource","href":"/api-reference/latest/webhooks/webhook-delivery"},{"title":"List webhook-deliveries","deprecated":null,"version":null,"sidebarTitle":"List webhook-deliveries","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-deliveries","href":"/api-reference/latest/webhooks/get-webhook-deliveries"},{"title":"Trigger a test delivery","deprecated":null,"version":null,"sidebarTitle":"Trigger a test delivery","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json post /lucca-api/webhook-deliveries","href":"/api-reference/latest/webhooks/post-webhook-deliveries"},{"title":"Retrieve a webhook-delivery","deprecated":null,"version":null,"sidebarTitle":"Retrieve a webhook-delivery","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-deliveries/{id}","href":"/api-reference/latest/webhooks/get-webhook-delivery"},{"title":"The webhook-delivery-attempt resource","href":"/api-reference/latest/webhooks/webhook-delivery-attempt"},{"title":"List webhook-delivery-attempts","deprecated":null,"version":null,"sidebarTitle":"List webhook-delivery-attempts","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-delivery-attempts","href":"/api-reference/latest/webhooks/get-webhook-delivery-attempts"},{"title":"Retrieve a webhook-delivery-attempt","deprecated":null,"version":null,"sidebarTitle":"Retrieve a webhook-delivery-attempt","tag":"beta","openapi":"/openapi-specs/lucca-api@2024-11-01.json get /lucca-api/webhook-delivery-attempts/{id}","href":"/api-reference/latest/webhooks/get-webhook-delivery-attempt"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},{"version":"V3 \u0026 V4 (legacy)","tag":"legacy","pages":[{"title":"V3 \u0026 V4 (legacy)","href":"/home"}]}]},"basePath":"","title":"Get Started With Taxonomies - Lucca API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}