Language Status

Get the detailed translation progress for specified language.

Request

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

POST https://api.crowdin.com/api/project/{project-identifier}/language-status?key={project-key}
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.
project-key string Project API key. Either the project-key or combination of username and account-key are required.
username string Your username in Crowdin. Either the project-key or combination of username and account-key are required.
account-key string Your account API key. Either the project-key or combination of username and account-key are required.

Response

If successful, this method returns a XML structure, as it is shown below. 
<?xml version="1.0" encoding="ISO-8859-1"?>
<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="ISO-8859-1"?>
<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?key={project-key}
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/language-status?key={project-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?