API V1 · Projects
Get translation status of all accessible workspace projects
curl --request GET \ --url https://api.lingohub.com/v1/acme-corp/projects/status \ --header 'Authorization: Bearer YOUR_API_KEY'import requests
url = "https://api.lingohub.com/v1/acme-corp/projects/status"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())const url = 'https://api.lingohub.com/v1/acme-corp/projects/status';const options = {method: 'GET', headers: {Authorization: 'Bearer YOUR_API_KEY'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}package main
import ( "fmt" "net/http" "io")
func main() {
url := "https://api.lingohub.com/v1/acme-corp/projects/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder() .url("https://api.lingohub.com/v1/acme-corp/projects/status") .get() .addHeader("Authorization", "Bearer YOUR_API_KEY") .build();
Response response = client.newCall(request).execute();<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.lingohub.com/v1/acme-corp/projects/status', [ 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', ],]);
echo $response->getBody();require 'uri'require 'net/http'
url = URI("https://api.lingohub.com/v1/acme-corp/projects/status")
http = Net::HTTP.new(url.host, url.port)http.use_ssl = true
request = Net::HTTP::Get.new(url)request["Authorization"] = 'Bearer YOUR_API_KEY'
response = http.request(request)puts response.read_bodyusing System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://api.lingohub.com/v1/acme-corp/projects/status"), Headers = { { "Authorization", "Bearer YOUR_API_KEY" }, },};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}Retrieves a list of the projects within the specified workspace the caller is allowed to view, each including:
* Standard attributes (title, URL)
* Translation status counts per locale, broken down by segment status (NOT_TRANSLATED, PRE_TRANSLATED, DRAFT, APPROVED)
This endpoint is useful for building dashboards or monitoring overall translation progress across projects.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The URL slug of the workspace. The project links that GET /v1/projects returns contain it: /v1/{workspaceUrl}/projects/{projectUrl}.
Example
acme-corpResponses
Section titled “Responses”Successfully returns a list of projects with their per-locale translation status breakdown.
Translation status overview for a project, including per-locale segment counts by status.
object
The title of the project.
The URL of the project in the LingoHub app.
The total number of translatable text segments in the project.
The segment counts per locale of the project’s default branch, by status: NOT_TRANSLATED, PRE_TRANSLATED, DRAFT and APPROVED.
object
object
Examples
Project with translation statuses per locale
ProjectStatuses
[ { "title": "lh-frontend", "url": "https://app.lingohub.com/project/pr_11HeYxUdI1lp-228/branches/prb_18vCn8SsCceB-17798", "totalCount": 5202, "status": { "fr": { "NOT_TRANSLATED": 88, "PRE_TRANSLATED": 5087, "DRAFT": 27, "APPROVED": 0 }, "en": { "NOT_TRANSLATED": 0, "PRE_TRANSLATED": 0, "DRAFT": 164, "APPROVED": 5038 } } }]Unauthorized: Authentication credentials are missing or invalid.
object
object
object
object
object
Example
{ "error": { "status": "100 CONTINUE" }}Forbidden: The authenticated user does not have permission to view this workspace.
object
Example generated
{ "url": "example", "message": "example", "text": "example"}Not Found: The specified workspace does not exist.
object
Example generated
{ "message": "example", "items": [ "example" ]}