---
title: "POST /2026-02-05/getListing"
method: POST
path: "/2026-02-05/getListing"
---

# POST /2026-02-05/getListing

`POST /2026-02-05/getListing`

Provides details about a listing, such as descriptions, badges, categories, pricing model summaries, reviews, and associated products and offers.

## Request body

- object
  - `listingId` string, required — The unique identifier of the listing to retrieve.

## Response `200`

Success

- GetListingOutput
  - `associatedEntities` ListingAssociatedEntity[], required — The products and offers associated with this listing. Each entity contains product and offer information.
    - `product` object — Information about the product associated with the listing.
      - `productId` string, required — The unique identifier of the product.
      - `productName` string, required — The human-readable display name of the product.
      - `manufacturer` object, required — The entity who manufactured the product.
        - `sellerProfileId` string, required — The unique identifier of the seller profile.
        - `displayName` string, required — The human-readable name of the seller.
    - `offer` object — Information about the default offer associated with the listing.
      - `offerId` string, required — The unique identifier of the offer.
      - `offerName` string — The display name of the offer.
      - `sellerOfRecord` object, required — The entity responsible for selling the product under this offer.
        - `sellerProfileId` string, required — The unique identifier of the seller profile.
        - `displayName` string, required — The human-readable name of the seller.
  - `badges` ListingBadge[], required — Badges indicating special attributes of the listing, such as free tier eligibility, free trial availability, or Quick Launch support.
    - `displayName` string, required — The human-readable name of the badge.
    - `badgeType` 'AWS_FREE_TIER' | 'FREE_TRIAL' | 'DEPLOYED_ON_AWS' | 'QUICK_LAUNCH' | 'MULTI_PRODUCT', required — The machine-readable type of the badge.
  - `catalog` string, required — The name of the catalog that the listing belongs to.
  - `categories` Category[], required — The categories used to classify this listing into logical groups.
    - `categoryId` string, required — The machine-readable identifier of the category.
    - `displayName` string, required — The human-readable name of the category.
  - `fulfillmentOptionSummaries` FulfillmentOptionSummary[], required — A summary of fulfillment options available for deploying or accessing the listing, such as AMI, SaaS, or Container.
    - `fulfillmentOptionType` 'AMAZON_MACHINE_IMAGE' | 'API' | 'CLOUDFORMATION_TEMPLATE' | 'CONTAINER' | 'HELM' | 'EKS_ADD_ON' | 'EC2_IMAGE_BUILDER_COMPONENT' | 'DATA_EXCHANGE' | 'PROFESSIONAL_SERVICES' | 'SAAS' | 'SAGEMAKER_ALGORITHM' | 'SAGEMAKER_MODEL', required — The machine-readable type of the fulfillment option, such as <code>SAAS</code> or <code>AMAZON_MACHINE_IMAGE</code>.
    - `displayName` string, required — The human-readable name of the fulfillment option type.
  - `highlights` NonEmptyString[], required — A list of key features that the listing offers to customers.
  - `integrationGuide` string — Optional guidance explaining how to use data in this listing. Primarily defines how to integrate with a multi-product listing.
  - `listingId` string, required — The unique identifier of the listing.
  - `listingName` string, required — The human-readable display name of the listing.
  - `logoThumbnailUrl` string, required — The URL of the logo thumbnail image for the listing.
  - `longDescription` string, required — A detailed description of what the listing offers, in paragraph format.
  - `pricingModels` PricingModel[], required — The pricing models for offers associated with this listing, such as usage-based, contract, BYOL, or free.
    - `pricingModelType` 'USAGE' | 'CONTRACT' | 'BYOL' | 'FREE', required — The machine-readable type of the pricing model.
    - `displayName` string, required — The human-readable name of the pricing model.
  - `pricingUnits` PricingUnit[], required — The pricing units that define the billing dimensions for offers associated with this listing, such as users, hosts, or data.
    - `pricingUnitType` 'USERS' | 'HOSTS' | 'BANDWIDTH' | 'DATA' | 'TIERS' | 'REQUESTS' | 'UNITS', required — The machine-readable type of the pricing unit.
    - `displayName` string, required — The human-readable name of the pricing unit.
  - `promotionalMedia` PromotionalMedia[], required — Embedded promotional media provided by the creator of the product, such as images and videos.
    - `embeddedImage` PromotionalEmbeddedImage — An embedded promotional image for a product.
      - `title` string, required — The title displayed when hovering over the image.
      - `url` string, required — The URL of the image file.
      - `description` string — An optional description of the image.
    - `embeddedVideo` PromotionalEmbeddedVideo — An embedded promotional video for a product.
      - `title` string, required — The title displayed when hovering over the video.
      - `url` string, required — The URL of the video file.
      - `preview` string, required — The URL of the high-resolution preview image for the video.
      - `thumbnail` string, required — The URL of the thumbnail image for the video.
      - `description` string — An optional description of the video.
  - `publisher` object, required — The entity who created and published the listing.
    - `sellerProfileId` string, required — The unique identifier of the seller profile.
    - `displayName` string, required — The human-readable name of the seller.
  - `resources` Resource[], required — Resources that provide further information about using the product or requesting support, such as documentation links, support contacts, and usage instructions.
    - `resourceType` 'MANUFACTURER_SUPPORT' | 'MANUFACTURER_INSTRUCTIONS', required — The category of the resource, such as manufacturer support or usage instructions.
    - `contentType` 'EMAIL' | 'PHONE_NUMBER' | 'LINK' | 'OTHER', required — The format of the resource content, such as a URL, email address, or text.
    - `value` string, required — The resource content. Interpretation depends on the content type.
    - `displayName` string — An optional human-readable label for the resource.
  - `reviewSummary` object — A summary of customer reviews available for the listing, including average rating and total review count by source.
    - `reviewSourceSummaries` ReviewSourceSummary[], required — Review summaries from different sources, such as AWS Marketplace.
      - `sourceName` string, required — The name of the review source, such as AWS Marketplace.
      - `sourceId` 'AWS_MARKETPLACE', required — The machine-readable identifier of the review source.
      - `sourceUrl` string — The URL where the reviews can be accessed at the source.
      - `averageRating` string, required — The average rating across all reviews from this source.
      - `totalReviews` integer, required — The total number of reviews available from this source.
  - `sellerEngagements` SellerEngagement[], required — Engagement options available to potential buyers, such as requesting a private offer or requesting a demo.
    - `engagementType` 'REQUEST_FOR_PRIVATE_OFFER' | 'REQUEST_FOR_DEMO', required — The type of engagement, such as <code>REQUEST_FOR_PRIVATE_OFFER</code> or <code>REQUEST_FOR_DEMO</code>.
    - `contentType` 'LINK', required — The format of the engagement value, such as a URL.
    - `value` string, required — The engagement value, such as a URL to the engagement form.
  - `shortDescription` string, required — A 1–3 sentence summary describing the key aspects of the listing.
  - `useCases` UseCaseEntry[], required — Use cases associated with the listing, describing scenarios where the product can be applied.
    - `useCase` object, required — The use case details.
      - `description` string, required — A description of the use case.
      - `displayName` string, required — The human-readable name of the use case.
      - `value` string, required — The machine-readable identifier of the use case.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — ResourceNotFoundException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/marketplace-discovery.md) · [All operations](https://skmtc.net/aws/apis/marketplace-discovery/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/marketplace-discovery/versions/07e08a16d022/schema)