View a markdown version of this page

ListListingAttributes - AWS Marketplace

ListListingAttributes

Retrieves the requested attributes for a listing, including case studies and trust center information. The operation returns results in pages. Use nextToken to retrieve the next page.

Important

Do not depend on the order of attribute types in the response. The order does not follow the order of the values in attributeTypes. The service does not guarantee any order between attribute types, and the order can change without notice. You should identify each entry by the attribute type it contains instead of relying on its position in the list.

Request Syntax

POST /2026-02-05/listListingAttributes HTTP/1.1 Content-type: application/json { "attributeTypes": [ "string" ], "listingId": "string", "locale": "string", "maxResults": number, "nextToken": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

attributeTypes

The attribute types to retrieve. Specify one or more of the following values:

CASE_STUDY

Case studies associated with the listing.

SPECIALIZATION_DETAIL

Specializations earned for the listing.

TRUST_CENTER_CERTIFICATION

Trust center certifications associated with the listing.

TRUST_CENTER_CONTROL

Trust center controls associated with the listing.

TRUST_CENTER_DOCUMENT

Trust center documents associated with the listing.

TRUST_CENTER_FAQ

The trust center FAQ associated with the listing.

TRUST_CENTER_SOURCE

Trust center sources associated with the listing.

TRUST_CENTER_UPDATE

Trust center updates associated with the listing.

The order of these values does not control the order of attribute types in the response.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Valid Values: CASE_STUDY | SPECIALIZATION_DETAIL | TRUST_CENTER_SOURCE | TRUST_CENTER_CERTIFICATION | TRUST_CENTER_DOCUMENT | TRUST_CENTER_CONTROL | TRUST_CENTER_FAQ | TRUST_CENTER_UPDATE

Required: Yes

listingId

The unique identifier of the listing whose attributes are requested.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [\w\-]+

Required: Yes

locale

The preferred locale for response content, as a Best Current Practice 47 (BCP 47) language tag or a comma-separated priority list of language tags. See Locale for supported values, constraints, fallback behavior, and the default locale. If you omit this field, the service returns content in the default locale.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: [^;,]+(\s*,\s*[^;,]+){0,1}

Required: No

maxResults

The maximum number of attributes to return in each call. If you omit this field, the default is 25. Use nextToken to retrieve the next page.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

nextToken

If the service returns nextToken, more results are available. The value of nextToken is a unique pagination token for each page. Make the call again with the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. An expired pagination token returns a ValidationException.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Pattern: [a-zA-Z0-9+/=]+

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "listingAttributes": [ { ... } ], "locale": "string", "nextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

listingAttributes

The requested attributes. Each entry contains one attribute type.

The order of attribute types in this list is not guaranteed.

Type: Array of ListingAttributeResults objects

locale

The locale of the returned content. See Locale for details.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: [^;,]+(\s*,\s*[^;,]+){0,1}

nextToken

If the service returns nextToken, more results are available. The value of nextToken is a unique pagination token for each page. Make the call again with the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. An expired pagination token returns a ValidationException.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Pattern: [a-zA-Z0-9+/=]+

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

You don't have sufficient access to perform this operation. For the permissions that each operation requires, see Access control for the AWS Marketplace Discovery API in the AWS Marketplace Developer Guide.

HTTP Status Code: 403

InternalServerException

Unexpected error during processing of the request.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource doesn't exist. Verify that the identifier is correct.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling. Reduce the frequency of your requests and retry.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the constraints specified by the service. Check the reason field for the constraint that failed.

reason

The reason that the input fails to satisfy the constraints that the Discovery API specifies. This field has one of the following values:

INVALID_PAGINATION_TOKEN

The nextToken value is malformed, expired, or belongs to a different request. Start the pagination again from the first page.

MALFORMED_REQUEST_PARAMETERS

One or more request parameters have an invalid value. Correct the parameters that you specified, and then resubmit your request.

PAGINATION_LIMIT_EXCEEDED

The request asks for results beyond the deepest page that the operation returns. Narrow your request with filters or a more specific search.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: