GET/v2/projects/{projectId}/translations/select-all

List key IDs matching translation filters

Lists the IDs of localization keys that match the supplied translation-view filters in a project. Combine filters to select keys by language, translation state, key properties, tags, tasks, comments, labels, or QA issues. Use repeated query parameters where supported to provide multiple filter values.

47 parameters
projectIdintegerrequired
The unique identifier of the project whose keys to select.
filterStatearray<string>optional
Filter by translation state using `languageTag,state`; you can repeat this parameter. Multiple states for one language are combined with OR, while multiple languages are combined with AND.
languagesarray<string>optional
Language tags to include in the result; repeat this parameter to include multiple languages.
searchstringoptional
Search text matched against localization key names or translation text.
filterKeyNamearray<string>optional
Select keys by name; repeat this parameter to include multiple key names.
filterKeyIdarray<integer>optional
Select keys by numeric identifier; repeat this parameter to include multiple IDs.
filterUntranslatedAnybooleanoptional
Set to true to select keys missing a translation in any returned language.
filterTranslatedAnybooleanoptional
Set to true to select keys with a translation in any language.
filterUntranslatedInLangstringoptional
Select keys missing a translation in this language. The language must be included in `languages` for this filter to apply.
filterTranslatedInLangstringoptional
Select keys with a translation in this language.
filterAutoTranslatedInLangarray<string>optional
Select keys with an automatically translated value in any of the specified languages.
filterHasScreenshotbooleanoptional
Set to true to select keys with screenshots.
filterHasNoScreenshotbooleanoptional
Set to true to select keys without screenshots.
filterHasDescriptionbooleanoptional
Set to true to select keys with a description.
filterHasNoDescriptionbooleanoptional
Set to true to select keys without a description.
filterIsPluralbooleanoptional
Set to true to select plural keys.
filterIsNotPluralbooleanoptional
Set to true to select non-plural keys.
filterNamespacearray<string>optional
Select keys in the specified namespaces. Use an empty string to select the default namespace.
filterNoNamespacearray<string>optional
Select keys not in the specified namespaces. Use an empty string to filter for the default namespace.
filterKeyPatternarray<string>optional
Select keys whose names match the supplied pattern. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterNoKeyPatternarray<string>optional
Select keys whose names do not match the supplied pattern. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterDescriptionPatternarray<string>optional
Select keys whose descriptions match the supplied pattern; keys without descriptions never match. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterNoDescriptionPatternarray<string>optional
Select keys whose descriptions do not match the supplied pattern; keys without descriptions always match. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterNamespacePatternarray<string>optional
Select keys whose non-default namespace matches the supplied pattern. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterNoNamespacePatternarray<string>optional
Select keys whose namespace does not match the supplied pattern; keys in the default namespace always match. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterTranslationPatternarray<string>optional
Select keys with translation text matching `languageTag,pattern`; use `*` as the language tag to match any returned language. The language tag must be included in `languages`. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterNoTranslationPatternarray<string>optional
Select keys without translation text matching `languageTag,pattern`; use `*` as the language tag to match any returned language. Keys with no translation in the specified language always match, and the language tag must be included in `languages`. Patterns are case-insensitive; `*` matches any sequence, a leading `=` requests an exact match, and `%` and `_` are literal. Repeat this parameter to require all patterns to match. Each pattern must be non-empty, at most 500 characters, and contain no more than 5 wildcards; provide at most 20 patterns.
filterTagarray<string>optional
Select keys that have at least one of the specified tags.
filterNoTagarray<string>optional
Select keys that do not have the specified tags.
filterOutdatedLanguagearray<string>optional
Select keys whose translations are outdated in any of the specified languages.
filterNotOutdatedLanguagearray<string>optional
Select keys whose translations are not outdated in any of the specified languages.
filterRevisionIdarray<integer>optional
Select keys affected by activity in any of the specified revision IDs.
filterFailedKeysOfJobintegeroptional
Select keys that were not successfully translated by the specified batch job ID.
filterTaskNumberarray<integer>optional
Select keys included in any of the specified task numbers.
filterTaskKeysNotDonebooleanoptional
Set to true to select task keys that are not done.
filterTaskKeysDonebooleanoptional
Set to true to select task keys that are done.
filterTaskInLangarray<string>optional
Filter task membership using `languageTag,taskType,status`. Status must be IN_OPEN_TASK, NOT_IN_OPEN_TASK, HAS_BEEN_IN_TASK, or NEVER_IN_TASK; a task is open while NEW or IN_PROGRESS. Conditions across task types use AND, and this filter does not affect `filterTaskNumber`.
filterHasUnresolvedCommentsInLangarray<string>optional
Select keys with unresolved comments in any of the specified languages.
filterHasCommentsInLangarray<string>optional
Select keys with comments in any of the specified languages.
filterLabelarray<string>optional
Select key translations that have any of the specified labels.
filterHasQaIssuesInLangarray<string>optional
Select keys with open QA issues in any of the specified languages.
filterQaCheckTypearray<string>optional
Select keys with a QA issue matching `languageTag,checkType`; repeat this parameter to provide multiple filters. A key matches when any selected check type is present in any selected language.
filterQaChecksStaleInLangarray<string>optional
Select keys with at least one translation whose QA checks are stale in any of the specified languages.
filterHasSuggestionsInLangarray<string>optional
Select keys with suggestions in any of the specified languages.
filterHasNoSuggestionsInLangarray<string>optional
Select keys without suggestions in any of the specified languages.
branchstringoptional
Select keys from the specified branch.
filterDeletedByUserIdarray<integer>optional
Filter trashed keys by the user IDs of the users who deleted them.

5 status codes
200Returns an object containing `ids`, an array of numeric localization key IDs matching the filters.
idsarray<integer>required
400Returned when a filter value is invalid, including malformed patterns or a translation-pattern language not included in the returned languages.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
401Returned when the request is unauthenticated.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
403Returned when you do not have permission to access the project or its keys.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
404Returned when the project cannot be found.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional

Error handling

A 400 is returned when a filter value is invalid, including a pattern that is empty, over 500 characters, contains more than 5 wildcards, or exceeds 20 values, or a translation-pattern language is not included in languages. A 401 is returned when authentication is missing or invalid, a 403 when you lack permission, and a 404 when the project cannot be found. The projectId path parameter must identify the project; task filters must follow their documented formats and status values.