Language Status

Get the detailed translation progress for specified language.

Request

POST https://api.crowdin.com/api/project/{project-identifier}/language-status?key={project-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 required string Should contain the project identifier.
project-key required string Project API key.

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?