---
title: "Convert XDT to Termbase Structure"
method: POST
path: "/termbase-templates/convert-xdt"
tags: ["Termbase Template"]
---

# Convert XDT to Termbase Structure

`POST /termbase-templates/convert-xdt`

Converts a termbase definition (XDT file) to a termbase structure that will be returned in the response.<br>
The structure will not be stored in the Trados Cloud Platform.

## Query parameters

- `fields` string

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Response `200`

OK

- TermbaseStructure — The termbase structure.
  - `languages` Language[] — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The languages of the termbase.</div>
    - `languageCode` string, required — Language code. ex: "en-US", "de-DE".
    - `englishName` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">Human readable name.</div>
    - `direction` string
    - `parentLanguageCode` string
    - `defaultSpecificLanguageCode` string
    - `isNeutral` boolean, nullable
  - `fields` TermbaseField[] — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The termbase fields. (Not available for List Termbases endpoint).</div>
    - `id` string, required — The identifier of the termbase field.
    - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The name of the termbase field.</div>
    - `description` string, nullable — The description of the termbase field
    - `type` 'system' | 'userDefined' — The type of the termbase field - system or userDefined.
    - `level` 'entry' | 'language' | 'term' — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The level of which this field applies.</div>
    - `dataType` 'text' | 'double' | 'date' | 'picklist' | 'boolean' — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The data type of the field.</div>
    - `pickListValues` string[] — The pick list options. Only if dataType is "picklist".
    - `allowCustomValues` boolean — Specifies if the field allows custom values.
    - `allowMultiple` boolean — Specifies if the field can be used multiple times.
    - `isMandatory` boolean — Specifies if the field is mandatory.

## Other responses

- `400` — Error code “invalid” in case of: * Empty or missing file in request * Not valid multipart request * File parameter contains other extension than the one expected by specification.
- `401` — Unauthorized
- `403` — Error codes: * "entitlementMissing": - Your subscription does not include access to the requested type of benefit.

---

[API](https://skmtc.net/rws/apis/trados-cloud-platform-api.md) · [All operations](https://skmtc.net/rws/apis/trados-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rws/trados-cloud-platform-api/revisions/d42dac7c28a3/schema)