---
title: "getContentDocument"
method: GET
path: "/aplus/2020-11-01/contentDocuments/{contentReferenceKey}"
tags: ["A+ Content Management v2020-11-01"]
---

# getContentDocument

`GET /aplus/2020-11-01/contentDocuments/{contentReferenceKey}`

Returns an A+ Content document, if available.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 10 | 10 |

The `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `contentReferenceKey` string, required

## Query parameters

- `marketplaceId` string, required
- `includedDataSet` string[], required

## Response `200`

Success.

- GetContentDocumentResponse — The base response data for all A+ Content operations when a request is successful or partially successful. Individual operations can extend this with additional data.
  - `warnings` Error[] — A set of messages to the user, such as warnings or comments.
    - `code` string, required — An error code that identifies the type of error that occurred.
    - `message` string, required — A message that describes the error condition.
    - `details` string — Additional details that can help the caller understand or fix the issue.
  - `contentRecord` ContentRecord, required — A content document with additional information for content management.
    - `contentReferenceKey` string, required — A unique reference key for the A+ Content document. A content reference key cannot form a permalink and might change in the future. A content reference key is not guaranteed to match any A+ content identifier.
    - `contentMetadata` ContentMetadata — The A+ Content document's metadata.
      - `name` string, required — The A+ Content document's name.
      - `marketplaceId` string, required — The identifier of the Amazon marketplace. For the list of all marketplace IDs, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
      - `status` 'APPROVED' | 'DRAFT' | 'REJECTED' | 'SUBMITTED', required — The submission status of the content document.
      - `badgeSet` ContentBadge[], required — The set of content badges.
      - `updateTime` string, date-time, required — The approximate age of the A+ Content document and metadata.
    - `contentDocument` ContentDocument — The A+ Content document. This is the enhanced content that is published to product detail pages.
      - `name` string, required — The A+ Content document name.
      - `contentType` 'EBC' | 'EMC', required — The A+ Content document type.
      - `contentSubType` string — The A+ Content document subtype. This represents a special-purpose type of an A+ Content document. Not every A+ Content document type has a subtype, and subtypes can change at any time.
      - `locale` string, required — The IETF language tag, which supports the primary language subtag and one secondary language subtag. The secondary language subtag is usually a regional designation. This doesn't support subtags other than the primary and secondary subtags. **Pattern:** ^[a-z]{2,}-[A-Z0-9]{2,}$
      - `contentModuleList` ContentModule[], required — A list of A+ Content modules.
        - `contentModuleType` 'STANDARD_COMPANY_LOGO' | 'STANDARD_COMPARISON_TABLE' | 'STANDARD_FOUR_IMAGE_TEXT' | 'STANDARD_FOUR_IMAGE_TEXT_QUADRANT' | 'STANDARD_HEADER_IMAGE_TEXT' | 'STANDARD_IMAGE_SIDEBAR' | 'STANDARD_IMAGE_TEXT_OVERLAY' | 'STANDARD_MULTIPLE_IMAGE_TEXT' | 'STANDARD_PRODUCT_DESCRIPTION' | 'STANDARD_SINGLE_IMAGE_HIGHLIGHTS' | 'STANDARD_SINGLE_IMAGE_SPECS_DETAIL' | 'STANDARD_SINGLE_SIDE_IMAGE' | 'STANDARD_TECH_SPECS' | 'STANDARD_TEXT' | 'STANDARD_THREE_IMAGE_TEXT', required — The type of A+ Content module.
        - `standardCompanyLogo` StandardCompanyLogoModule — The standard company logo image.
          - `companyLogo` ImageComponent, required — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
        - `standardComparisonTable` StandardComparisonTableModule — The standard product comparison table.
          - `productColumns` StandardComparisonProductBlock[]
            - `position` integer, required — The rank or index of this comparison product block within the module. Different blocks cannot occupy the same position within a single module.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `title` string — The comparison product title.
            - `asin` string — The ASIN of the item.
            - `highlight` boolean — When true, indicates that this content block is visually highlighted.
            - `metrics` PlainTextItem[] — Comparison metrics for the product.
              - …
          - `metricRowLabels` PlainTextItem[]
            - `position` integer, required — The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
            - `value` string, required — The actual plain text.
        - `standardFourImageText` StandardFourImageTextModule — Four standard images with text, presented across a single row.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `block1` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block2` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block3` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block4` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardFourImageTextQuadrant` StandardFourImageTextQuadrantModule — Four standard images with text, presented on a grid of four quadrants.
          - `block1` StandardImageTextBlock, required — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block2` StandardImageTextBlock, required — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block3` StandardImageTextBlock, required — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block4` StandardImageTextBlock, required — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardHeaderImageText` StandardHeaderImageTextModule — Standard headline text, an image, and body text.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardImageSidebar` StandardImageSidebarModule — Two images, two paragraphs, and two bulleted lists. One image is smaller and displayed in the sidebar.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `imageCaptionBlock` StandardImageCaptionBlock — The A+ Content standard image and caption block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `caption` TextComponent — Rich text content.
              - …
          - `descriptionTextBlock` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `descriptionListBlock` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
            - `textList` TextItem[], required
              - …
          - `sidebarImageTextBlock` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `sidebarListBlock` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
            - `textList` TextItem[], required
              - …
        - `standardImageTextOverlay` StandardImageTextOverlayModule — A standard background image with a floating text box.
          - `overlayColorType` 'DARK' | 'LIGHT', required — The relative color scheme of your content.
          - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardMultipleImageText` StandardMultipleImageTextModule — Standard images with text, presented one at a time. The user clicks on thumbnails to view each block.
          - `blocks` StandardImageTextCaptionBlock[]
            - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
              - …
            - `caption` TextComponent — Rich text content.
              - …
        - `standardProductDescription` StandardProductDescriptionModule — Standard product description text.
          - `body` ParagraphComponent, required — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `standardSingleImageHighlights` StandardSingleImageHighlightsModule — A standard image with several paragraphs and a bulleted list.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `textBlock1` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `textBlock2` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `textBlock3` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `bulletedListBlock` StandardHeaderTextListBlock — The A+ standard fixed-length list of text and a related headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `block` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
              - …
        - `standardSingleImageSpecsDetail` StandardSingleImageSpecsDetailModule — A standard image with paragraphs, a bulleted list, and extra space for technical details.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `descriptionHeadline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `descriptionBlock1` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `descriptionBlock2` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `specificationHeadline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `specificationListBlock` StandardHeaderTextListBlock — The A+ standard fixed-length list of text and a related headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `block` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
              - …
          - `specificationTextBlock` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardSingleSideImage` StandardSingleSideImageModule — A standard headline and body text with an image on the side.
          - `imagePositionType` 'LEFT' | 'RIGHT', required — The content's relative positioning.
          - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
        - `standardTechSpecs` StandardTechSpecsModule — The standard table of technical feature names and definitions.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `specificationList` StandardTextPairBlock[], required — The specification list.
            - `label` TextComponent — Rich text content.
              - …
            - `description` TextComponent — Rich text content.
              - …
          - `tableCount` integer — The number of tables you want present. Features are evenly divided between the tables.
        - `standardText` StandardTextModule — A standard headline and body text.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent, required — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `standardThreeImageText` StandardThreeImageTextModule — Three standard images with text, presented across a single row.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `block1` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block2` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `block3` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `401` — The request's Authorization header is not formatted correctly or does not contain a valid token.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The specified resource does not exist.
- `410` — The specified resource no longer exists.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)
