The Lucca API does not localize responses based on the client’s locale. Instead, it provides exhaustive data, allowing clients to localize content according to their own users’ preferences.
Some resource properties in the Lucca API support translations. When they do, the response will include a reserved t9n object containing localized versions of those properties. This object maps translatable property names to a dictionary of translations, keyed by IETF BCP 47 language tags:
In this example, the name property holds the invariant (default) value. The t9n object provides localized alternatives, allowing the client to choose the most appropriate translation based on user preferences.
Only the invariant value is guaranteed to be present. The t9n translations are optional and may be incomplete.
Client guidanceWhen displaying localized values, clients should attempt to match the user’s language preferences as closely as possible. A common fallback strategy would be:
1
Look for a region-specific tag
For example: "fr-CH".
2
Fall back to alternative language tag(s)
For example: "fr-FR", then "fr".
3
Finally, use the invariant value
This ensures a graceful degradation in case specific translations are not available.
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.4271","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":"documentation/using-api/t9n","slug":"/documentation/using-api/t9n","pageMetadata":{"title":"Translations (t9n) \u0026 Localization (l10n)","sidebarTitle":"Translations (t9n)","description":"Learn how the Lucca API handles translations.","icon":"language","href":"/documentation/using-api/t9n"},"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 how the Lucca API handles translations.\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Step,Steps,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:`The Lucca API does not localize responses based on the client’s locale. Instead, it provides exhaustive data, allowing clients to localize content according to their own users’ preferences.`}),`\n`,_jsxs(_components.p,{children:[`Some resource properties in the Lucca API support translations. When they do, the response will include a reserved `,_jsx(_components.code,{children:`t9n`}),` object containing localized versions of those properties. This object maps translatable property names to a dictionary of translations, keyed by `,_jsx(_components.a,{href:`https://tools.ietf.org/html/bcp47`,children:`IETF BCP 47`}),` language tags:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INVARIANT_NAME\"`}),_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:` \"t9n\"`}),_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"FRENCH-INT_NAME\"`}),_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:` \"fr-FR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"FRENCH-FRANCE_NAME\"`}),_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:` \"fr-CH\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"FRENCH-SWITZERLAND_NAME\"`}),_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:` \"en\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ENGLISH-INT_NAME\"`}),_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:` \"en-US\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ENGLISH-US_NAME\"`})]}),`\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`,_jsx(_components.p,{children:`In this example, the name property holds the invariant (default) value. The t9n object provides localized alternatives, allowing the client to choose the most appropriate translation based on user preferences.`}),`\n`,_jsxs(Warning,{children:[`Only the invariant value is guaranteed to be present. The `,_jsx(_components.code,{children:`t9n`}),` translations are optional and may be incomplete.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Client guidance`})}),`\n`,_jsx(_components.p,{children:`When displaying localized values, clients should attempt to match the user’s language preferences as closely as possible. A common fallback strategy would be:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Look for a region-specific tag`,children:_jsxs(_components.p,{children:[`For example: `,_jsx(_components.code,{children:`\"fr-CH\"`}),`.`]})}),_jsx(Step,{title:`Fall back to alternative language tag(s)`,children:_jsxs(_components.p,{children:[`For example: `,_jsx(_components.code,{children:`\"fr-FR\"`}),`, then `,_jsx(_components.code,{children:`\"fr\"`}),`.`]})}),_jsx(Step,{title:`Finally, use the invariant value`})]}),`\n`,_jsx(_components.p,{children:`This ensures a graceful degradation in case specific translations are not available.`})]})}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":"Translations (t9n) \u0026 Localization (l10n)","sidebarTitle":"Translations (t9n)","description":"Learn how the Lucca API handles translations.","icon":"language","href":"/documentation/using-api/t9n"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"lucca","siteName":"Lucca API","title":"Translations (t9n) \u0026 Localization (l10n) - Lucca API","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{"V5 (latest)":{"href":"/documentation/using-api/t9n","matchLevel":0},"V3 \u0026 V4 (legacy)":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-01-26T12:54:21.496Z","originalFileLocation":"documentation/using-api/t9n.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 how the Lucca API handles translations.\">\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=\"Translations (t9n) \u0026amp; Localization (l10n) - Lucca API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how the Lucca API handles translations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lucca API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.luccasoftware.com/documentation/using-api/t9n\">\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=Using+Lucca+API\u0026amp;title=Translations++%28t9n%29+%26+Localization+%28l10n%29\u0026amp;description=Learn+how+the+Lucca+API+handles+translations.\u0026amp;theme=78529ce9555b182511a1fe1d\u0026amp;signature=483d45414a3981c203d2622f7ec41f18c7e630e3751fa8dcb6305cb7c68d9108\">\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=\"Translations (t9n) \u0026amp; Localization (l10n) - Lucca API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how the Lucca API handles translations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lucca.mintlify.site/_mintlify/api/og/v2?division=Using+Lucca+API\u0026amp;title=Translations++%28t9n%29+%26+Localization+%28l10n%29\u0026amp;description=Learn+how+the+Lucca+API+handles+translations.\u0026amp;theme=78529ce9555b182511a1fe1d\u0026amp;signature=483d45414a3981c203d2622f7ec41f18c7e630e3751fa8dcb6305cb7c68d9108\">\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/documentation/using-api/t9n\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/using-api/t9n.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/documentation/using-api/t9n#webpage\",\"url\":\"https://developers.luccasoftware.com/documentation/using-api/t9n\",\"name\":\"Translations (t9n) \u0026 Localization (l10n)\",\"description\":\"Learn how the Lucca API handles translations.\",\"dateModified\":\"2026-01-26T12:54:21.496Z\",\"isPartOf\":{\"@id\":\"https://developers.luccasoftware.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.luccasoftware.com/documentation/using-api/t9n#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.luccasoftware.com/documentation/using-api/t9n#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Using Lucca API\",\"item\":\"https://developers.luccasoftware.com/documentation/using-api/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Translations (t9n) \u0026 Localization (l10n)\",\"item\":\"https://developers.luccasoftware.com/documentation/using-api/t9n\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.luccasoftware.com/documentation/using-api/t9n#article\",\"headline\":\"Translations (t9n) \u0026 Localization (l10n)\",\"name\":\"Translations (t9n) \u0026 Localization (l10n)\",\"description\":\"Learn how the Lucca API handles translations.\",\"url\":\"https://developers.luccasoftware.com/documentation/using-api/t9n\",\"mainEntityOfPage\":{\"@id\":\"https://developers.luccasoftware.com/documentation/using-api/t9n#webpage\"},\"dateModified\":\"2026-01-26T12:54:21.496Z\",\"publisher\":{\"@id\":\"https://developers.luccasoftware.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.luccasoftware.com#website\"}}]}\u003c/script>","agentPointerHref":"/documentation/using-api/t9n.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","groups":[{"group":"Get Started","pages":[{"title":"The Lucca API","sidebarTitle":"Introduction","mode":"wide","icon":"house","href":"/documentation/get-started/introduction"},{"title":"Quick Start","icon":"rocket","mode":"wide","href":"/documentation/get-started/quickstart"},{"title":"URL \u0026 Environments","icon":"cloud","href":"/documentation/get-started/environments"}]},{"group":"Using Lucca API","pages":[{"group":"Authentication","icon":"key","pages":[{"title":"Get Started With Authentication","sidebarTitle":"Get Started","mode":"wide","href":"/documentation/using-api/authentication"},{"openapi":"authentication POST /connect/token","title":"Create Access-Token","href":"/documentation/using-api/authentication-spec"}]},{"title":"Versioning","mode":"wide","icon":"code-branch","href":"/documentation/using-api/versioning"},{"title":"Filtering","icon":"filter","href":"/documentation/using-api/filtering"},{"title":"Pagination","icon":"forward","href":"/documentation/using-api/paging"},{"title":"Sorting","icon":"bars-sort","href":"/documentation/using-api/sorting"},{"title":"Includes","icon":"expand","href":"/documentation/using-api/includes"},{"title":"Error Handling","icon":"circle-exclamation","href":"/documentation/using-api/errors"},{"title":"HTTP Cache","sidebarTitle":"Cache","mode":"wide","icon":"feather","href":"/documentation/using-api/cache"},{"title":"Data Types \u0026 Formatting","sidebarTitle":"Data Types","description":"The Lucca API normalizes the formatting of some data types.","icon":"shapes","href":"/documentation/using-api/data-types"},{"title":"Translations (t9n) \u0026 Localization (l10n)","sidebarTitle":"Translations (t9n)","icon":"language","href":"/documentation/using-api/t9n"}]},{"group":"Webhooks","pages":[{"title":"Get Started With Webhooks \u0026 Events","sidebarTitle":"Get Started","description":"Use incoming webhook events to get real-time updates","icon":"rocket","href":"/documentation/webhooks/get-started"},{"group":"Catching events","icon":"hand","pages":[{"title":"Get Started","href":"/documentation/webhooks/catching/get-started"},{"title":"Receive events","sidebarTitle":"Receive events","openapi":"webhook-client-api POST /{webhook-endpoint}","href":"/documentation/webhooks/catching/spec-receive"},{"title":"Respond to Activation","sidebarTitle":"Respond to Activation","openapi":"webhook-client-api GET /{webhook-endpoint}","href":"/documentation/webhooks/catching/spec-activate"},{"title":"Validating events","icon":"code-simple","href":"/documentation/webhooks/catching/validate"},{"title":"Declare Your Webhook-Endpoint","href":"/documentation/webhooks/catching/declare"}]},{"title":"Troubleshooting","icon":"fire-extinguisher","href":"/documentation/webhooks/troubleshooting"}]},{"group":"MCP","tag":"beta","pages":[{"title":"Connect an AI Assistant to Lucca","sidebarTitle":"Setup","icon":"plug","href":"/documentation/mcp/setup"},{"title":"MCP Tools","sidebarTitle":"Tools","icon":"wrench","mode":"wide","href":"/documentation/mcp/tools"}]},{"group":"Resources","pages":[{"title":"Sandbox","icon":"cube","href":"/documentation/sandbox"},{"title":"Limits","icon":"monitor-waveform","href":"/documentation/limits"},{"title":"Breaking Changes","icon":"bomb","href":"/documentation/breaking-changes"},{"title":"Playground","icon":"futbol","href":"/documentation/playground"},{"title":"Security Best Practices","icon":"shield-halved","href":"/documentation/security"},{"title":"Support","icon":"life-ring","href":"/documentation/support"},{"title":"API Guidelines","icon":"gavel","href":"/documentation/guidelines"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/latest/introduction"}]},{"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":"Translations (t9n) \u0026 Localization (l10n) - Lucca API","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":[],"chunks":[]}