---
title: "Get a document in a specific project"
method: GET
path: "/project/{project_id}/document/{document_path}"
tags: ["Content Document Operations"]
---

# Get a document in a specific project

`GET /project/{project_id}/document/{document_path}`

Get a document from a specific project. Documents with state unpublished will be retrieved.

Only documents that have been previously added to a project will show on the response. Check how to [make changes to channels and content in a Project](https://documentation.bloomreach.com/content/docs/make-changes-to-channels-and-content-in-a-project).

A document in core may be have changes that aren't yet published, these are stored in a separate variant of the document (the 'unpublished' variant). When requesting a document for core, the 'published' variant is retrieved, unless there is none (the page has never been published yet), in which case the unpublished variant is fetched.

## Path parameters

- `project_id` string, required
- `document_path` string, required

## Response `200`

OK

- Document — A document is a content item in the Content repository. See [Content types](https://documentation.bloomreach.com/content/reference/content-type-fields) and [General concepts](https://documentation.bloomreach.com/content/docs/content-model-concepts)
  - `contentType` string, required — the content type of the document (eg banner, newsArticle). The value for the contentType may optionally include the namespace prefix; this is only required in case the type is in a namespace other than 'brxsaas', eg mynamespace:content
  - `fields` DocumentField[], required — fields of this document. A document field represents an attribute of the document, as specified in the document's content type. See [Content type fields](https://documentation.bloomreach.com/content/reference/content-type-fields) and [General concepts](https://documentation.bloomreach.com/content/docs/content-model-concepts)
    - `name` string, required — identifying name of this field. Value needs to correspond to the name of a field definition in the document's content type
    - `value` FieldValue[], required — value of a field. As fields can be multiple, this attribute is an array of values
      - union — Value of a field
        - object — See [EmbeddedResource](https://documentation.bloomreach.com/content/reference/content-type-fields#embeddedresource)
          - `filename` string, required — the name of the file that is used as default value
          - `binarydata` string, required — the binary data of the file that is used as default value. This data has to be encoded using base64
          - `mimeType` string, required — the mimeType of the file to be uploaded
        - object — See [FieldGroup](https://documentation.bloomreach.com/content/reference/content-type-fields#fieldgroup)
          - `fields` object, required — fields from FieldGroup or SelectableFieldGroup
        - object — See [Selectable FieldGroup](https://documentation.bloomreach.com/content/reference/content-type-fields#selectable-fieldgroup)
          - `fields` object, required — fields from FieldGroup or SelectableFieldGroup
          - `fieldGroupType` string, required — the name of the fieldgroup type this default value is provided for. Unless the field group type belongs to the default group ('brxsaas'), the name must be prefixed with the group name and the colon character, e.g. 'mygroup:myfieldgrouptype'
  - `name` string, required — identifying name of this document. Only valid characters are lowercase alphanumeric, dash, dot, and underscore. This value appears in URLs. The value must alsomatch the document name(last part of the path) in the document path.
  - `displayName` string, required — name of this document. Used in labels in the CMS UI and in Delivery API. The displayName can only be set if either is true:a. the document is new, b. the document only exists in the project specified in this operation
  - `locale` string — document locale
  - `path` string, required — absolute path of this document in the content repository
  - `system` System — System properties
    - `createdBy` string — the name of the user that created the webhook configuration
    - `createdAt` string, date-time — date of create
    - `updatedBy` string — the name of the user that updated the webhook configuration
    - `updatedAt` string, date-time — date of update

## 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)