---
title: "Retrieve a Project"
method: GET
path: "/v2/projects"
tags: ["Projects"]
---

# Retrieve a Project

`GET /v2/projects`

Retrieves one or more projects, including the documents associated with each project. Retrieving a project is the most efficient way to retrieve a single project, multiple projects or a list of all available projects.

To retrieve a specific project, specify the `id` request parameter or you can retrieve multiple projects by adding comma (,) between ids eg. `?id=1234,5678`. To retrieve all projects, omit the `id` request parameter. To limit the retrieved projects to those with a particular source language or target language, specify the corresponding ISO 639-1 language codes in the `srclang` and `trglang` request parameters, respectively.

## Query parameters

- `id` integer
- `srclang` string
- `trglang` string
- `from_time` integer
- `to_time` integer
- `state` string
- `archived` boolean
- `connector_id` integer

## Response `200`

A list of Project objects.

- Project[]
  - `id` integer — A unique number identifying the Project.
  - `memory_id` integer — A unique number identifying the associated Memory.
  - `job_id` integer — A unique number identifying the associated Job.
  - `srclang` string — An ISO 639-1 language identifier.
  - `trglang` string — An ISO 639-1 language identifier.
  - `srclocale` string — A locale identifier, supported for srclang.
  - `trglocale` string — A locale identifier, supported for trglang.
  - `name` string — A name for the project.
  - `state` string — The project's state. The possible states are `backlog`, `inProgress`, `inReview`, `inQA`, and `done`.
  - `due_date` integer — The due date. Measured in seconds since the Unix epoch.
  - `archived` boolean — The archived state of the Project.
  - `metadata` object — A JSON object of key/value string pairs. Stores custom project information.
  - `sample_review_percentage` integer — The project's sample review percentage.
  - `created_at` integer — Time at which the object was created. Measured in seconds since the Unix epoch.
  - `updated_at` integer — Time at which the object was created. Measured in seconds since the Unix epoch.
  - `workflowStatus` 'READY_TO_START' | 'IN_PROGRESS' | 'DONE' — The status of the Workflow for the current project. This may not be present for all project endpoints even with workflows enabled.
  - `document` DocumentWithoutSegments[] — A list of Documents.
    - `id` integer — A unique number identifying the Document.
    - `project_id` integer — A unique number identifying the Project.
    - `srclang` string — An ISO 639-1 language identifier.
    - `trglang` string — An ISO 639-1 language identifier.
    - `name` string — The document name.
    - `import_in_progress` boolean — True if the document is currently being imported
    - `import_succeeded` boolean — True if the import process succeeded.
    - `import_error_message` string — Error message if `import_succeeded=false`
    - `export_in_progress` boolean — True if the document is currently being exported for download
    - `export_succeeded` boolean — True if the export process succeeded.
    - `export_error_message` string — Error message if `export_succeeded=false`
    - `is_pretranslating` boolean — True if the document is currently being pretranslated.
    - `status` object — A list of translations for the query term.
      - `pretranslation` 'idle' | 'pending' | 'running'
    - `translator_email` string — The email of the assigned translator.
    - `reviewer_email` string — The email of the assigned reviewer.
    - `customer_reviewer_email` string — The email of the assigned customer reviewer. Only present if the project was request by id.
    - `created_at` integer — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `updated_at` integer — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `is_review_complete` boolean — Document review status.

## Other responses

- `401` — Unauthorized
- `default` — Unexpected error

---

[API](https://skmtc.net/lilt/apis/lilt-api.md) · [All operations](https://skmtc.net/lilt/apis/lilt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lilt/lilt-api/versions/444772351ac3/schema)