---
title: "Find project issues"
method: POST
path: "/issues-api/v2/projects/{projectId}/issues/list"
tags: ["Issues"]
---

# Find project issues

`POST /issues-api/v2/projects/{projectId}/issues/list`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/issues-api/v2/projects/{projectId}/issues/list`
- Auth: HTTP bearer

Returns a list of issues matching specified filter options. You can filter based on the date issues were created, target languages, strings, issue types, states, issue numbers, job unique ids, issues not associated with strings in a job, issue assignee, and which user opened the issue. Unless otherwise specified, the request will return a maximum of 30 results. All parameters are optional.

## Path parameters

- `projectId` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

## Request body

- FindRequest
  - `createdDateBefore` string: Filter issues which were created before this date.
  - `createdDateAfter` string: Filter issues which were created after this date.
  - `resolvedDateBefore` string: Filter issues which were resolved before this date.
  - `resolvedDateAfter` string: Filter issues which were resolved after this date.
  - `answered` boolean: Issue flag "answered".
  - `reopened` boolean: Issue flag "reopened".
  - `issueSeverityLevelCodes` string[]
  - `issueStateCodes` string[]
  - `issueSubTypeCodes` string[]
  - `issueTypeCodes` string[]
  - `issueWatchingStateCode` 'WATCHING' | 'NOT_WATCHING': Issue Watching State identifier.
  - `reportedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
  - `assigneeUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
  - `hasComments` boolean: Does the issue have any comments? True for issues that have comments. False for issues that have only the original description but no comments.
  - `issueNumbers` integer[]
  - `jobFilter` object
    - `jobUids` TranslationJobUid[]
    - `presence` 'HAS_ANY' | 'HAS_NOTHING': What kind of issues have to be presented
  - `stringFilter` object
    - `hashcodes` string[]
    - `localeIds` LocaleId[]
  - `limit` integer: limit
  - `offset` integer: offset
  - `sortBy` object: Sort result by fields
    - `items` object[]
      - `direction` 'ASC' | 'DESC': Sort direction
      - `fieldName` 'issueTypeCode' | 'issueSubTypeCode' | 'issueStateCode' | 'createdDate' | 'resolvedDate' | 'hashcode' | 'issueText' | 'issueTextModifiedDate' | 'resolvedByUserUid' | 'reportedByUserUid' | 'assigneeUserUid' | 'lastCommentDate': Sort by certain field

## Response `200`

OK

- IssuesFindResponse
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `items` object[]
        - `answered` boolean: Issue flag "aswered"
        - `createdDate` string: Issue creation date
        - `lastCommentDate` string: Comment Activity Date
        - `issueSeverityLevelCode` 'LOW' | 'MEDIUM' | 'HIGH': [Issue Severity Level identifier](#operation/getAllIssueSeverityLevels)
        - `issueStateCode` 'OPENED' | 'RESOLVED': [Issue State identifier](#operation/getAllIssuesStates)
        - `issueSubTypeCode` 'CLARIFICATION' | 'MISSPELLING' | 'POOR_TRANSLATION' | 'DOES_NOT_FIT_SPACE' | 'PLACEHOLDER_ISSUE' | 'REVIEW_TRANSLATION' | 'CUSTOM' | 'MT_ERROR': Issue SubType identifier
        - `issueText` string: Issue text
        - `issueTextModifiedDate` string: Issue text modification date
        - `issueTypeCode` 'SOURCE' | 'TRANSLATION': [Issue Type identifier](#operation/getIssueTypesByAccount)
        - `issueUid` string: Issue identifier
        - `projectId` string: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
        - `accountUid` string: The account’s unique identifier. This can be found in the Smartling Dashboard under Account Settings > API.
        - `issueNumber` integer: Issue number
        - `reportedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `resolvedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `assigneeUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `resolvedDate` string: Issue resolve date
        - `reopened` boolean: Issue flag "reopened"
        - `reopenedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `reopenedDate` string: Issue reopen date
        - `string` object
          - `hashcode` string: MD5 hash digest — 32 lowercase hexadecimal characters.
          - `localeId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
        - `issueCommentsCount` integer: Issue comments count
      - `totalCount` integer: Total element count

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added
- **2026-08-06** `ae422098d9c5`: 1 breaking
  - api removed without deprecation

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/issues-api/v2/projects/:projectId/issues/list/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)