Skip to main content
GET
/
api
/
v1
/
projects
curl -X GET \
  https://studio.dubformer.ai/api/v1/projects \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": "proj_5f83a14b2ec1b",
    "name": "Marketing Campaign 2023",
    "status": "new",
    "translationGlossary": "gloss_5f83a14b2ec1b",
    "voicesGlossary": "voices_7c92e3a1f56d8",
    "remark": "Urgent project for Q4 launch",
    "clientName": "Acme Corp",
    "projectUrl": "https://studio.dubformer.ai/projects/proj_5f83a14b2ec1b",
    "createdAt": "2023-12-01T10:00:00.000Z",
    "updatedAt": "2023-12-01T15:30:00.000Z"
  },
  {
    "id": "proj_6e74b25c3fd2a",
    "name": "Company Training Videos",
    "status": "in_progress",
    "translationGlossary": null,
    "voicesGlossary": null,
    "remark": null,
    "clientName": "Internal",
    "projectUrl": "https://studio.dubformer.ai/projects/proj_6e74b25c3fd2a",
    "createdAt": "2023-11-15T08:00:00.000Z",
    "updatedAt": "2023-12-01T12:00:00.000Z"
  }
]
This endpoint returns a list of all projects that the authenticated user has access to.

​
Response

Returns an array of project objects, each containing the following fields:
​
id
string
Unique project identifier.
​
name
string
Name of the project.
​
status
string
Current status of the project.
​
translationGlossary
string | null
ID of the translation glossary, if any.
​
voicesGlossary
string | null
ID of the voices glossary, if any.
​
remark
string | null
Project remarks, if any.
​
clientName
string | null
Client name, if specified.
​
projectUrl
string
URL to access the project in the web app.
​
createdAt
string
ISO 8601 timestamp when the project was created.
​
updatedAt
string
ISO 8601 timestamp when the project was last updated.
curl -X GET \
  https://studio.dubformer.ai/api/v1/projects \
  -H 'Authorization: Bearer YOUR_API_KEY'

[
  {
    "id": "proj_5f83a14b2ec1b",
    "name": "Marketing Campaign 2023",
    "status": "new",
    "translationGlossary": "gloss_5f83a14b2ec1b",
    "voicesGlossary": "voices_7c92e3a1f56d8",
    "remark": "Urgent project for Q4 launch",
    "clientName": "Acme Corp",
    "projectUrl": "https://studio.dubformer.ai/projects/proj_5f83a14b2ec1b",
    "createdAt": "2023-12-01T10:00:00.000Z",
    "updatedAt": "2023-12-01T15:30:00.000Z"
  },
  {
    "id": "proj_6e74b25c3fd2a",
    "name": "Company Training Videos",
    "status": "in_progress",
    "translationGlossary": null,
    "voicesGlossary": null,
    "remark": null,
    "clientName": "Internal",
    "projectUrl": "https://studio.dubformer.ai/projects/proj_6e74b25c3fd2a",
    "createdAt": "2023-11-15T08:00:00.000Z",
    "updatedAt": "2023-12-01T12:00:00.000Z"
  }
]

​
Notes

Projects are returned in descending order by creation date (newest first).
Only projects belonging to the authenticated user’s company are returned.