---
title: "Get Project Status"
method: GET
path: "/v2.0/public/projects/{projectId}/status"
tags: ["Project Management"]
---

# Get Project Status

`GET /v2.0/public/projects/{projectId}/status`

When invoked, Get Project Status returns current project status and — if input data errors
were detected — error information associated with each input data unit where an error occurred.
            
A project’s state can change due to REST API calls executed by your code, changes made to a project in
the Enterprise Portal as well as project-related events occurring at Defined.ai.
It is not guaranteed that project states follow a sequential, ordered progression. 
             
| REST API Call Invocation | Project Related Event | Project Status | Invokable REST API Calls |
|:-------------|:-------------|:-------------|:-------------|
| Create Project | Project has been created | NOT ACTIVE | Upload Data Units 
 Delete Project |
| Upload Data Units | Defined.ai is running validation | PROCESSING DATA UPLOAD | |
| | Upload to Defined.ai is complete and no errors were detected | UPLOAD SUCCESS | Upload Data Units 
 Delete Project |
| | Upload to Defined.ai is complete but Defined.ai found errors in some Input Units | UPLOAD ERRORS | Upload Data Units 
 Delete Project |
| | Upload to Defined.ai is complete but no data unit is valid | INSUFFICIENT DATA | Upload Data Units 
 Delete Project |
| | Defined.ai is preparing the project before deploying it to our human intelligence community | PREPARING PROJECT | Cancel Project |
| | Defined.ai has deployed the project to our human intelligence community | RUNNING | Cancel Project |
| | Defined.ai is accessing the quality of the human intelligence community | ASSESSING QUALITY | Cancel Project |
| | Defined.ai is curating and preparing the results for download | GENERATING RESULTS | |
| | Defined.ai has completed the project and data is available for download  | PROJECT COMPLETED | Delete Project 
 Get Deliverables |
| Cancel Project | Defined.ai has canceled the project | CANCELLED | Delete Project |
| Delete Project | Defined.ai has deleted the project | DELETED | |


             
**Permission Required:** Read Project Properties

## Path parameters

- `projectId` string, uuid, required

## Response `200`

The ProjectStatus structure.

- DefinedCrowdPublicApiApiResultsProjectGetProjectStatusQueryResults
  - `projectDetails` DefinedCrowdPublicApiApiResultsProjectProjectDetails
    - `id` string, uuid — Project Identifier.
    - `name` string, nullable — Name of the project.
    - `projectType` string, nullable — Code that identifies a project template type
    - `status` string, nullable — The project's current status.
    - `dateTimeCreated` string, date-time — Date and time when the project was created.
    - `dateTimeLastRun` string, date-time, nullable — Date and time when the project last ran.
    - `progress` integer — Reflects the progress of execution of a specific project. This value is subject to changes. The progress might decrease as the latest collected data is still subject to quality validations.
    - `estimatedDateToComplete` string, date-time, nullable — A projection of the project completion date. This is not a committed date. The date is a projection based on the average speed at which data is collected and may vary.
    - `totalNumberInputUnitsSubmitted` integer — Total number of input units submitted for the project.
    - `totalNumberOutputUnitsCompleted` integer — Number of data units already completed.
    - `targetNumberOutputDataUnits` integer — Number of target data units.
    - `uploadInputUnitsError` DefinedCrowdPublicApiApiResultsProjectUploadInputUnitError[], nullable — List of errors in the data unit uploading asynchronous process.
      - `inputDataUnitId` string, uuid — Unique identifier of the input data unit where the error occurred.
      - `errorType` 'connectionUnsuccessful' | 'fileDoesNotExist' | 'fileIsNotValid' | 'unauthorizedAccess' | 'statusCodeDoesNotIndicateSuccess' | 'platformError' | 'urlNotSupported' — Type of error.
      - `errorDetails` string, nullable — Details of error.
      - `errorProperty` DefinedCrowdPublicApiApiResultsProjectErrorProperty
        - `inputDataUnitProperty` string, nullable — Name of property for which error exists.
        - `inputDataUnitPropertyValue` string, nullable — Original value of the property for which error exists.
      - `inputDataUnit` unknown

## Other responses

- `401` — Invalid authentication (project from another enterprise or invalid/expired token).
- `404` — Project does not exist.

---

[API](https://skmtc.net/definedcrowd/apis/defined-ai-api.md) · [All operations](https://skmtc.net/definedcrowd/apis/defined-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/definedcrowd/defined-ai-api/revisions/14cab8ac3bca/schema)