# Get translation status of all accessible workspace projects

`GET https://api.lingohub.com/v1/{workspaceUrl}/projects/status`

LingoHub API V1 · [Projects](https://developers.lingohub.com/reference/v1/operations/tags/projects.md) · operation `v1ProjectGetProjectStatusInfos`

    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, DRAFT, TRANSLATED, PREFILLED, APPROVED)

    This endpoint is useful for building dashboards or monitoring overall translation progress across projects.


## Parameters

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `workspaceUrl` | path | yes | string | workspaceUrl |

## Example request

```sh
curl --request GET \
  --url https://api.lingohub.com/v1/WORKSPACE_URL/projects/status \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Responses

- `200`: Successfully returns a list of projects with their per-locale translation status breakdown.
- `401`: Unauthorized: Authentication credentials are missing or invalid.
- `403`: Forbidden: The authenticated user does not have permission to view this workspace.
- `404`: Not Found: The specified workspace does not exist.

## OpenAPI definition

The complete definition of this operation, with every schema it references:

````json
{
  "openapi": "3.1.0",
  "info": {
    "title": "LingoHub API V1",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.lingohub.com",
      "description": "Generated server url"
    }
  ],
  "tags": [
    {
      "name": "Projects",
      "description": "Endpoints for the operations that can be performed on projects of a workspace"
    }
  ],
  "paths": {
    "/v1/{workspaceUrl}/projects/status": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "Get translation status of all accessible workspace projects",
        "description": "    Retrieves a list of the projects within the specified workspace the caller is allowed to view, each including:\n\n     * Standard attributes (title, URL)\n     * Translation status counts per locale, broken down by segment status (NOT_TRANSLATED, DRAFT, TRANSLATED, PREFILLED, APPROVED)\n\n    This endpoint is useful for building dashboards or monitoring overall translation progress across projects.\n",
        "operationId": "v1ProjectGetProjectStatusInfos",
        "parameters": [
          {
            "name": "workspaceUrl",
            "in": "path",
            "description": "workspaceUrl",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully returns a list of projects with their per-locale translation status breakdown.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProjectStatus"
                  }
                },
                "examples": {
                  "projectStatuses": {
                    "summary": "Project with translation statuses per locale",
                    "description": "projectStatuses",
                    "value": [
                      {
                        "title": "lh-frontend",
                        "url": "https://app.lingohub.com/project/pr_11HeYxUdI1lp-228/branches/prb_18vCn8SsCceB-17798",
                        "totalCount": 5202,
                        "status": {
                          "fr": {
                            "PREFILLED": 5087,
                            "DRAFT": 27,
                            "TRANSLATED": 0,
                            "NOT_TRANSLATED": 88,
                            "APPROVED": 0
                          },
                          "en": {
                            "PREFILLED": 0,
                            "DRAFT": 164,
                            "TRANSLATED": 0,
                            "NOT_TRANSLATED": 0,
                            "APPROVED": 5038
                          }
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized: Authentication credentials are missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorInfo"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden: The authenticated user does not have permission to view this workspace.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorInfo"
                }
              }
            }
          },
          "404": {
            "description": "Not Found: The specified workspace does not exist.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ErrorInfo"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ProjectStatus": {
        "type": "object",
        "description": "Translation status overview for a project, including per-locale segment counts by status.",
        "properties": {
          "title": {
            "type": "string",
            "description": "The title of the project.",
            "example": "My Mobile App"
          },
          "url": {
            "type": "string",
            "description": "The URL-friendly slug of the project.",
            "example": "my-mobile-app"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32",
            "description": "The total number of translatable text segments in the project.",
            "example": 1250
          },
          "status": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "integer",
                "format": "int32"
              }
            },
            "description": "The translation status breakdown per locale. Each locale maps segment statuses (e.g. TRANSLATED, UNTRANSLATED, UNVERIFIED) to their respective counts."
          }
        }
      },
      "V1ErrorInfo": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "description": "API key authentication. Create API keys in your LingoHub workspace settings. Keys use the `lh-api_` prefix. Pass the full key as the Bearer token.",
        "scheme": "bearer"
      }
    }
  }
}
````
