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.
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_UPDATERequired: 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
Localefor 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
nextTokento 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 ofnextTokenis 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 aValidationException.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
Localefor 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 ofnextTokenis 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 aValidationException.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
reasonfield 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
nextTokenvalue 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: