---
title: "Get a developer project"
method: GET
path: "/{project_id}"
tags: ["Project Operations"]
---

# Get a developer project

`GET /{project_id}`

Gets a developer project.

## Path parameters

- `project_id` string, required

## Query parameters

- `withSubresources` boolean

## Response `200`

OK

- Project — A developer project
  - `id` string — identifier of the project. autogenerated during create project operation
  - `name` string, required — identifying name of the project
  - `includeContentTypes` boolean — whether to include content types in the project. this allows users to add/edit the content types in the scope of the project. there could be maximum of only one project which includes content types
  - `description` string — description of the project
  - `state` ProjectState — State of the project
    - `status` 'IN_PROGRESS' | 'ADDING_CHANNEL' | 'REBASING' | 'REBASE_ERROR' | 'IN_REVIEW' | 'APPROVED' | 'MERGING' | 'MERGED' | 'MERGE_ERROR' | 'DELETED' | 'DELETING' | 'RUNNING' | 'START_RUNNING' | 'STOP_RUNNING' — Project Status * IN_PROGRESS - The project is in progress * ADDING_CHANNEL - A channel is getting added to the project * REBASING - The project is getting rebased * REBASE_ERROR - The previous rebase operation has been failed * IN_REVIEW - The project is in review * APPROVED - The project changes has been approved * MERGING - The project is getting merged * MERGED - The project has been merged successfully * MERGE_ERROR - The previous merge operation has been failed * DELETED - The project has been deleted * DELETING - Not supported * RUNNING - Not supported * START_RUNNING - Not supported * STOP_RUNNING - Not supported
    - `message` string — status message
    - `errors` ProjectErrors, nullable — Merge or rebase errors of the items
      - `channels` ProjectError[] — channels with merge or rebase errors
        - `target` string — the project item
        - `message` string — error message for the project item
      - `contentTypes` ProjectError[] — content types with merge or rebase errors
        - `target` string — the project item
        - `message` string — error message for the project item
      - `documents` ProjectError[] — documents with merge or rebase errors
        - `target` string — the project item
        - `message` string — error message for the project item
      - `pages` ProjectError[] — pages with merge or rebase errors
        - `target` string — the project item
        - `message` string — error message for the project item
      - `resourceBundles` ProjectError[] — resource bundles with merge or rebase errors
        - `target` string — the project item
        - `message` string — error message for the project item
    - `availableActions` string[] — available actions for the current state. REBASE_PROJECT value is included if the project can be rebased
  - `items` ProjectItems, nullable — Items added to the project
    - `channels` ProjectChannel[] — channels added to the project
      - `id` string — identifier of the channel
      - `displayName` string — display name of the channel
    - `contentTypes` ProjectContentType[] — content types added to the project
      - `name` string — name of the content type
      - `displayName` string — display name of the content type
    - `documents` ProjectDocument[] — documents added to the project
      - `path` string — content path of the document
      - `displayName` string — display name of the document
    - `pages` ProjectPage[] — pages added to the project
      - `path` string — content path of the page
      - `displayName` string — display name of the page
    - `resourceBundles` ProjectResourceBundle[] — resource bundles added to the project
      - `path` string — content path of the resource bundle
      - `displayName` string — display name of the resource bundle
  - `system` ProjectSystem — System properties
    - `createdBy` string — the name of the user who created the project
    - `createdAt` string, date-time — date of create
    - `updatedBy` string — the name of the user who updated the project
    - `updatedAt` string, date-time — date of update
    - `mergedBy` string, nullable — the name of the user who merged the project
    - `mergedAt` string, date-time, nullable — date of merge

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0.md) · [All operations](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bloomreach/documents-delivery-api-2-0/revisions/87bfc06578c2/schema)