---
title: "List Target Files"
method: GET
path: "/projects/{projectId}/target-files"
tags: ["Target File"]
---
# List Target Files
`GET /projects/{projectId}/target-files`
Retrieves the target files for a project.
## Query parameters
- `targetFileIds` string[]
- `sourceFileIds` string[]
- `top` integer
- `skip` integer
- `fields` string
## Headers
- `Authorization` string, required
- `X-LC-Tenant` string, required
## Response `200`
- ListTargetFilesResponse — A response for the List Target Files endpoint.
- `itemCount` integer, required
- `items` TargetFile[], required
- `id` string, required
- `name` string — default
The target file name.
- `languageDirection` LanguageDirection — A Language Direction.
- `id` string, required — The language direction identifier.
- `sourceLanguage` Language, required — The language object.
- `languageCode` string, required — Language code. ex: "en-US", "de-DE".
- `englishName` string — default
Human readable name.
- `direction` string
- `parentLanguageCode` string
- `defaultSpecificLanguageCode` string
- `isNeutral` boolean, nullable
- `targetLanguage` Language, required — The language object.
- `languageCode` string, required — Language code. ex: "en-US", "de-DE".
- `englishName` string — default
Human readable name.
- `direction` string
- `parentLanguageCode` string
- `defaultSpecificLanguageCode` string
- `isNeutral` boolean, nullable
- `analysisStatistics` AnalysisStatistics
- `exactMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `inContextExactMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `perfectMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `new` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `repetitions` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `crossDocumentRepetitions` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `machineTranslation` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `locked` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `fuzzyMatch` FuzzyCount[] — default
Statistics count.
- `count` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `category` FuzzyCategory — Fuzzy category range. Example of Fuzzy bands: 100-100%, 95-99%, 85-94%, 75-84%, 50-74%.
- `minimum` integer, nullable — default
The minimum of the range.
- `maximum` integer, nullable — default
The maximum of the range.
- `total` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `sourceFile` SourceFile — Source File.
- `id` string, required
- `name` string — default
The file name.
- `role` 'translatable' | 'reference' | 'localizable' | 'unknown', nullable
- `language` Language — The language object.
- `languageCode` string, required — Language code. ex: "en-US", "de-DE".
- `englishName` string — default
Human readable name.
- `direction` string
- `parentLanguageCode` string
- `defaultSpecificLanguageCode` string
- `isNeutral` boolean, nullable
- `versions` SourceFileVersion[] — The source file versions. (Not available for List endpoints).
- `id` string, required — The source file version identifier.
- `type` 'native' | 'bcm', nullable — default
The version type.
- `name` string — default
The file version name. This is a synthetic value, typically constructed from the version number and the originating task name.
- `version` integer, required — A numeric value, incremented for each new version.
- `originatingTaskId` string — The identifier of the task that generated the file.
- `targetLanguages` Language[]
- `languageCode` string, required — Language code. ex: "en-US", "de-DE".
- `englishName` string — default
Human readable name.
- `direction` string
- `parentLanguageCode` string
- `defaultSpecificLanguageCode` string
- `isNeutral` boolean, nullable
- `path` string[]
- `totalWords` integer — Word count in the source file. Available only for translatable source files, and only after the workflow task with Task Type `convert` (File Format Conversion) was executed on the source file. Available only on the List Source Files endpoint.
- `latestVersion` TargetFileLatestVersion — Target File Latest Version.
- `id` string, required — The target file version identifier.
- `type` 'native' | 'bcm', nullable — default
The version type.
- `version` integer, required — A numeric value, incremented for each new version.
- `analysisStatistics` AnalysisStatistics
- `exactMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `inContextExactMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `perfectMatch` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `new` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `repetitions` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `crossDocumentRepetitions` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `machineTranslation` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `locked` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `fuzzyMatch` FuzzyCount[] — default
Statistics count.
- `count` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `category` FuzzyCategory — Fuzzy category range. Example of Fuzzy bands: 100-100%, 95-99%, 85-94%, 75-84%, 50-74%.
- `minimum` integer, nullable — default
The minimum of the range.
- `maximum` integer, nullable — default
The maximum of the range.
- `total` Count — Statistics count.
- `words` integer, nullable — default
Number of words.
- `segments` integer, nullable — default
Number of segments.
- `characters` integer, nullable — default
Number of characters.
- `placeables` integer, nullable — default
Number of placeables.
- `tags` integer, nullable — default
Number of tags.
- `status` 'inProgress' | 'finished' | 'canceled', nullable — Shows if the file is still being processed (inProgress) or if it has been fully processed (finished) by the workflow. A target file is automatically marked as finished by the workflow engine, once there are no more tasks to be performed on it.
## Other responses
- `400` — Error codes: * “invalid”: Invalid input in the query parameter mentioned in the “name” field on the error response.
- `401` — The user could not be identified.
- `403` — Error codes: * "forbidden": the authenticated user is not allowed to read the target files on the project.
- `404` — Error codes: * "notFound": the project could not be found by identifier.
- `416` — Error codes: * "requestedRangeNotSatisfiable": The requested entity or one of its dependencies attempted to retrieve data outside the allowed range. Skip+Top might be outside the supported range.
---
[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)