Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

ListBenefits

Retrieves a paginated list of available benefits based on specified filter criteria.

Request Syntax


{
   "Catalog": "string",
   "FulfillmentTypes": [ "string" ],
   "MaxResults": number,
   "NextToken": "string",
   "Programs": [ "string" ],
   "Status": [ "string" ]
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

Note

In the following list, the required parameters are described first.

Catalog

The catalog identifier to filter benefits by catalog.

Type: String

Pattern: [A-Za-z0-9_-]+

Required: Yes

FulfillmentTypes

Filter benefits by specific fulfillment types.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 2 items.

Valid Values: CREDITS | CASH | ACCESS

Required: No

MaxResults

The maximum number of benefits to return in a single response.

Type: Integer

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

Required: No

NextToken

A pagination token to retrieve the next set of results from a previous request.

Type: String

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

Pattern: [\s\S]*

Required: No

Programs

Filter benefits by specific AWS partner programs.

Type: Array of strings

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

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

Pattern: [A-Za-z0-9_-]+

Required: No

Status

Filter benefits by their current status.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 2 items.

Valid Values: ACTIVE | INACTIVE

Required: No

Response Syntax


{
   "BenefitSummaries": [ 
      { 
         "Arn": "string",
         "Catalog": "string",
         "Description": "string",
         "FulfillmentTypes": [ "string" ],
         "Id": "string",
         "Name": "string",
         "Programs": [ "string" ],
         "Status": "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.

BenefitSummaries

A list of benefit summaries matching the specified criteria.

Type: Array of BenefitSummary objects

NextToken

A pagination token to retrieve the next set of results, if more results are available.

Type: String

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

Errors

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

AccessDeniedException

Thrown when the caller does not have sufficient permissions to perform the requested operation.

Message: A message describing the access denial.

HTTP Status Code: 400

InternalServerException

Thrown when an unexpected error occurs on the server side during request processing.

Message: A message describing the internal server error.

HTTP Status Code: 500

ResourceNotFoundException

Thrown when the requested resource cannot be found or does not exist.

Message: A message describing the resource not found error.

HTTP Status Code: 400

ThrottlingException

Thrown when the request rate exceeds the allowed limits and the request is being throttled.

Message: A message describing the throttling error.

HTTP Status Code: 400

ValidationException

Thrown when the request contains invalid parameters or fails input validation requirements.

FieldList: A list of fields that failed validation.
Message: A message describing the validation error.
Reason: The reason for the validation failure.

HTTP Status Code: 400