SMsmartling
Files

Status of file for each locale

Changed on

Returns information on a specific file.

Example:

  curl -X GET -H "Authorization: Bearer {token}" 'https://api.smartling.com/files-api/v2/projects/{projectId}/file/status?fileUri=file.properties'
get/files-api/v2/projects/{projectId}/file/status

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.

Query parameters

fileUristring required

URI path of a source file within a Smartling project.

Example:/content/en/home.json

Smartling value that uniquely identifies a file in Smartling

Response

OK

Example response

{
  "response": {
    "data": {
      "created": "2026-01-15T10:00:00Z",
      "fileUri": "/content/en/home.json",
      "items": [
        {
          "localeId": "fr-FR"
        }
      ],
      "lastUploaded": "2026-01-15T10:00:00Z"
    }
  }
}

Changes

  • 2cd7a8215799Revision changes
    • breaking

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

    • 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

    • breaking

      the /// response's property type changed from string to no type, and format from YYYY-MM-DDThh:mm:ssZ to no format for status

    • breaking

      the /// response's property type changed from string to no type, and format from YYYY-MM-DDThh:mm:ssZ to no format for status

    • warning

      added the new arb enum value to the /// response property for the response status

    • warning

      added the new asciidoc enum value to the /// response property for the response status

    • warning

      added the new dita enum value to the /// response property for the response status

    • warning

      added the new ditaZip enum value to the /// response property for the response status

    • warning

      added the new docm enum value to the /// response property for the response status

    • warning

      added the new flare enum value to the /// response property for the response status

    • warning

      added the new fluent enum value to the /// response property for the response status

    • warning

      added the new freemarker enum value to the /// response property for the response status

    • warning

      added the new imageJpg enum value to the /// response property for the response status

    • warning

      added the new imagePng enum value to the /// response property for the response status

    • warning

      added the new imageWebp enum value to the /// response property for the response status

    • warning

      added the new indd enum value to the /// response property for the response status

    • warning

      added the new javaProperties enum value to the /// response property for the response status

    • warning

      added the new mdx enum value to the /// response property for the response status

    • warning

      added the new pdf enum value to the /// response property for the response status

    • warning

      added the new plainText enum value to the /// response property for the response status

    • warning

      added the new rtf enum value to the /// response property for the response status

    • warning

      added the new svg enum value to the /// response property for the response status

    • warning

      added the new vsdm enum value to the /// response property for the response status

    • warning

      added the new vsdx enum value to the /// response property for the response status

    • warning

      added the new vtt enum value to the /// response property for the response status

    • warning

      added the new xcstrings enum value to the /// response property for the response status

    • warning

      added the new xliff2 enum value to the /// response property for the response status

    • info

      added to the /// response property allOf list for the response status

    • info

      added to the /// response property allOf list for the response status

    • info

      removed the java_properties enum value from the /// response property for the response status

    • info

      removed the plain_text enum value from the /// response property for the response status

    • info

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

  • ae422098d9c5Revision changes
    • warning

      added the new xlsxTemplate enum value to the /// response property for the response status

    • info

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

    • info

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