Jobs

This searches for jobs based on hashcodes (string identifiers), fileUris, and translationJobUids. Will return max of 100 translation job list items.

post/jobs-api/v3/projects/{projectId}/jobs/search

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

Example:84c012a33

A unique project identifier. This can be found in the Smartling Dashboard under Account Settings > API.

Request body

fileUrisFileUri[]

(Optional) The fileUris (file identifiers) used to search for jobs. Any job containing the specified fileUri will be returned.

hashcodesHashcode[]

(Optional) The hashcodes (string identifiers) used to search for jobs. Any job containing specified hashcodes will be returned.

translationJobUidsTranslationJobUid[]

(Optional) The translationJobUids (translation job identifiers) used to search for jobs. Any job containing the specified fileUri will be returned.

Example request

{
  "fileUris": [
    "/content/en/home.json"
  ],
  "hashcodes": [
    "d41d8cd98f00b204e9800998ecf8427e"
  ],
  "translationJobUids": [
    "j45v1uvsi3tx"
  ]
}

Response

OK

Example response

{
  "response": {
    "data": {
      "items": [
        {
          "createdDate": "2026-01-15T10:00:00Z",
          "dueDate": "2026-01-15T10:00:00Z",
          "jobNumber": "SMTL-123",
          "jobStatus": "DRAFT | AWAITING_AUTHORIZATION | IN_PROGRESS | COMPLETED | CANCELLED | CLOSED",
          "targetLocaleIds": [
            "fr-FR"
          ],
          "translationJobUid": "j45v1uvsi3tx",
          "referenceNumber": "CustomerReferenceNum1"
        }
      ]
    }
  }
}

Changes

    • breaking

      added the pattern ^[a-z0-9]{9}$ to the path request parameter projectId

    • breaking

      added the pattern ^[a-f0-9]{32}$ to the request property /

    • breaking

      added the pattern ^[a-z0-9]{12}$ to the request property /

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • info

      the ////// response's property pattern ^[a-z]{2}(-[A-Z]{2})?$ was added for the status

    • info

      the ///// response's property pattern ^[a-z0-9]{12}$ was added for the status

    • warning

      removed the optional property ///// from the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status