For Project Managers

For Translators

For Developers

API v1
API v2
Languages
Webhooks
IP Addresses

Company

Language Status

Please consider that API 2.0 is now the preferred version to be used. The old API will remain fully functional until the end of 2021.

Crowdin API v2
Get the detailed translation progress for specified language.

Request

Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

POST https://api.crowdin.com/api/project/{project-identifier}/language-status?login={username}&account-key={account-key}

Parameters

Name Value Description
language required string Crowdin language codes.
xml optional string May not contain value. Defines that response should be in XML format. Default response type.
json optional string May not contain value. Defines that response should be in JSON format.
jsonp optional string Callback function name. Defines that response should be in JSONP format.
Variables
project-identifier string Project identifier.
login string Your username in Crowdin.
account-key string Your account API key.

Response

If successful, this method returns a XML structure, as it is shown below. 
<?xml version="1.0" encoding="UTF-8"?>
<status>
  <files>
    <item>
      <node_type>directory</node_type>
      <id>29812</id>
      <name>Version 1.0</name>
      <files>
        <item>
          <node_type>file</node_type>
          <id>29827</id>
          <name>strings.xml</name>
          <node_type>file</node_type>
          <phrases>7</phrases>
          <translated>0</translated>
          <approved>0</approved>
          <words>32</words>
          <words_translated>0</words_translated>
          <words_approved>0</words_approved>
        </item>
      </files>
    </item>
    <item>
      <node_type>branch</node_type>
      <id>29824</id>
      <name>Version 2.0</name>
      <files>
        <item>
          <node_type>file</node_type>
          <id>29826</id>
          <name>strings.xml</name>
          <phrases>239</phrases>
          <translated>239</translated>
          <approved>10</approved>
          <words>1059</words>
          <words_translated>1059</words_translated>
          <words_approved>25</words_approved>
        </item>
      </files>
    </item>
    <item>
      <node_type>file</node_type>
      <id>29825</id>
      <name>description.txt</name>
      <phrases>1239</phrases>
      <translated>1239</translated>
      <approved>100</approved>
      <words>1990</words>
      <words_translated>1990</words_translated>
      <words_approved>309</words_approved>
    </item>
  </files>
</status>
Unsuccessful response sample: 
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>10</code>
  <message>Language was not found</message>
</error>

Examples

curl \
  -F "language=fr" \
  https://api.crowdin.com/api/project/{project-identifier}/language-status?login={username}&account-key={account-key}
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/language-status?login={username}&account-key={account-key}';

$post_params = array();
$post_params['language'] = 'fr';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_params);

$result = curl_exec($ch);
curl_close($ch);

echo $result;

Was this article helpful?