Skip to content

Get Single Project

GET
/api/data/projects/{project_id}
curl --request GET \
--url https://example.com/api/data/projects/example

Return a single project summary mirroring list semantics but scoped to one project.

Authorization:

  • User must have UserProjectLink OR UserTargetLink for this project

Target filtering rules:

  • PM/Admin via UserProjectLink: include all targets
  • Others: include only targets where a UserTargetLink exists for current user

Supports both internal ID and UUID formats for backward compatibility.

project_id
required
Project Id
string

Successful Response

Media typeapplication/json
UserProjectSummary
object
project_id
required
Project Id

Primary external time-ordered UUIDv7 identifier

string
name
required
Name

Display name of the project

string
continuous
required
Continuous

Whether this is a continuous project

boolean
edit_time
Any of:
number
edit_user
Any of:
string
status
Any of:
ProjectState
string
Allowed values: pending processing active complete cancelled
state
Any of:
ProjectState
string
Allowed values: pending processing active complete cancelled
deadline
Any of:
number
user_role
Any of:
string
files
required
Files

Files associated with this project

Array<object>
ProjectFileInfo
object
file_uuid
Any of:
string
file_name
required
File Name

Original filename

string
source_lang
Any of:
string
word_count
Any of:
integer
char_count
Any of:
integer
targets
required
Targets

Targets configured for this file

Array<object>
ProjectTargetInfo
object
target_lang
Any of:
string
target_uuid
Any of:
string
deadline
Any of:
number
row_count
required
Row Count

Number of TargetRow entries for this target

integer
last_edit_time
Any of:
number
user_role
Any of:
string
Example
{
"continuous": false,
"deadline": 1736208000,
"edit_time": 1735689600,
"edit_user": "pm@example.com",
"files": [
{
"file_name": "brochure.docx",
"file_uuid": "0195f5c8-5c2a-7b58-b3f5-9d5c8e4f1a24",
"source_lang": "eng",
"targets": [
{
"deadline": 1736110000,
"last_edit_time": 1735800000,
"row_count": 120,
"target_lang": "fra",
"target_uuid": "0195f5c8-5c2a-7b58-b3f5-9d5c8e4f1a25",
"user_role": "project_manager"
}
]
}
],
"name": "Marketing Brochure",
"project_id": "0195f5c8-5c2a-7b58-b3f5-9d5c8e4f1a23",
"state": "active",
"status": "active",
"user_role": "project_manager"
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}