PartnerCentralSellingAPI / Client / list_opportunities

list_opportunities

PartnerCentralSellingAPI.Client.list_opportunities(**kwargs)

This request accepts a list of filters that retrieve opportunity subsets as well as sort options. This feature is available to partners from Partner Central using the ListOpportunities API action.

To synchronize your system with Amazon Web Services, only list the opportunities that were newly created or updated. We recommend you rely on events emitted by the service into your Amazon Web Services account’s Amazon EventBridge default event bus, you can also use the ListOpportunities action.

We recommend the following approach:

• Find the latest LastModifiedDate that you stored, and only use the values that came from Amazon Web Services. Don’t use values generated by your system.

• When you send a ListOpportunities request, submit the date in ISO 8601 format in the AfterLastModifiedDate filter.

• Amazon Web Services only returns opportunities created or updated on or after that date and time. Use NextToken to iterate over all pages.

See also: AWS API Documentation

Request Syntax

response = client.list_opportunities(
    Catalog='string',
    CustomerCompanyName=[
        'string',
    ],
    Identifier=[
        'string',
    ],
    LastModifiedDate={
        'AfterLastModifiedDate': datetime(2015, 1, 1),
        'BeforeLastModifiedDate': datetime(2015, 1, 1)
    },
    LifeCycleReviewStatus=[
        'Pending Submission'|'Submitted'|'In review'|'Approved'|'Rejected'|'Action Required',
    ],
    LifeCycleStage=[
        'Prospect'|'Qualified'|'Technical Validation'|'Business Validation'|'Committed'|'Launched'|'Closed Lost',
    ],
    MaxResults=123,
    NextToken='string',
    Sort={
        'SortBy': 'LastModifiedDate'|'Identifier'|'CustomerCompanyName',
        'SortOrder': 'ASCENDING'|'DESCENDING'
    }
)

Parameters:

• Catalog (string) –

  [REQUIRED]

  Specifies the catalog associated with the request. This field takes a string value from a predefined list: AWS or Sandbox. The catalog determines which environment the opportunities are listed in. Use AWS for listing real opportunities in the Amazon Web Services catalog, and Sandbox for testing in secure, isolated environments.

• CustomerCompanyName (list) –

  Filters the opportunities based on the customer’s company name. This allows partners to search for opportunities associated with a specific customer by matching the provided company name string.

  • (string) –

• Identifier (list) –

  Filters the opportunities based on the opportunity identifier. This allows partners to retrieve specific opportunities by providing their unique identifiers, ensuring precise results.

  • (string) –

• LastModifiedDate (dict) –

  Filters the opportunities based on their last modified date. This filter helps retrieve opportunities that were updated after the specified date, allowing partners to track recent changes or updates.

  • AfterLastModifiedDate (datetime) –

    Specifies the date after which the opportunities were modified. Use this filter to retrieve only those opportunities that were modified after a given timestamp.

  • BeforeLastModifiedDate (datetime) –

    Specifies the date before which the opportunities were modified. Use this filter to retrieve only those opportunities that were modified before a given timestamp.

• LifeCycleReviewStatus (list) –

  Filters the opportunities based on their current lifecycle approval status. Use this filter to retrieve opportunities with statuses such as Pending Submission, In Review, Action Required, or Approved.

  • (string) –

• LifeCycleStage (list) –

  Filters the opportunities based on their lifecycle stage. This filter allows partners to retrieve opportunities at various stages in the sales cycle, such as Qualified, Technical Validation, Business Validation, or Closed Won.

  • (string) –

• MaxResults (integer) –

  Specifies the maximum number of results to return in a single call. This limits the number of opportunities returned in the response to avoid providing too many results at once.

  Default: 20

• NextToken (string) – A pagination token used to retrieve the next set of results in subsequent calls. This token is included in the response only if there are additional result pages available.

• Sort (dict) –

  An object that specifies how the response is sorted. The default Sort.SortBy value is LastModifiedDate.

  • SortBy (string) – [REQUIRED]

    Field name to sort by.

  • SortOrder (string) – [REQUIRED]

    Sort order.

    Default: Descending

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'OpportunitySummaries': [
        {
            'Arn': 'string',
            'Catalog': 'string',
            'CreatedDate': datetime(2015, 1, 1),
            'Customer': {
                'Account': {
                    'Address': {
                        'City': 'string',
                        'CountryCode': 'US'|'AF'|'AX'|'AL'|'DZ'|'AS'|'AD'|'AO'|'AI'|'AQ'|'AG'|'AR'|'AM'|'AW'|'AU'|'AT'|'AZ'|'BS'|'BH'|'BD'|'BB'|'BY'|'BE'|'BZ'|'BJ'|'BM'|'BT'|'BO'|'BQ'|'BA'|'BW'|'BV'|'BR'|'IO'|'BN'|'BG'|'BF'|'BI'|'KH'|'CM'|'CA'|'CV'|'KY'|'CF'|'TD'|'CL'|'CN'|'CX'|'CC'|'CO'|'KM'|'CG'|'CK'|'CR'|'CI'|'HR'|'CU'|'CW'|'CY'|'CZ'|'CD'|'DK'|'DJ'|'DM'|'DO'|'EC'|'EG'|'SV'|'GQ'|'ER'|'EE'|'ET'|'FK'|'FO'|'FJ'|'FI'|'FR'|'GF'|'PF'|'TF'|'GA'|'GM'|'GE'|'DE'|'GH'|'GI'|'GR'|'GL'|'GD'|'GP'|'GU'|'GT'|'GG'|'GN'|'GW'|'GY'|'HT'|'HM'|'VA'|'HN'|'HK'|'HU'|'IS'|'IN'|'ID'|'IR'|'IQ'|'IE'|'IM'|'IL'|'IT'|'JM'|'JP'|'JE'|'JO'|'KZ'|'KE'|'KI'|'KR'|'KW'|'KG'|'LA'|'LV'|'LB'|'LS'|'LR'|'LY'|'LI'|'LT'|'LU'|'MO'|'MK'|'MG'|'MW'|'MY'|'MV'|'ML'|'MT'|'MH'|'MQ'|'MR'|'MU'|'YT'|'MX'|'FM'|'MD'|'MC'|'MN'|'ME'|'MS'|'MA'|'MZ'|'MM'|'NA'|'NR'|'NP'|'NL'|'AN'|'NC'|'NZ'|'NI'|'NE'|'NG'|'NU'|'NF'|'MP'|'NO'|'OM'|'PK'|'PW'|'PS'|'PA'|'PG'|'PY'|'PE'|'PH'|'PN'|'PL'|'PT'|'PR'|'QA'|'RE'|'RO'|'RU'|'RW'|'BL'|'SH'|'KN'|'LC'|'MF'|'PM'|'VC'|'WS'|'SM'|'ST'|'SA'|'SN'|'RS'|'SC'|'SL'|'SG'|'SX'|'SK'|'SI'|'SB'|'SO'|'ZA'|'GS'|'SS'|'ES'|'LK'|'SD'|'SR'|'SJ'|'SZ'|'SE'|'CH'|'SY'|'TW'|'TJ'|'TZ'|'TH'|'TL'|'TG'|'TK'|'TO'|'TT'|'TN'|'TR'|'TM'|'TC'|'TV'|'UG'|'UA'|'AE'|'GB'|'UM'|'UY'|'UZ'|'VU'|'VE'|'VN'|'VG'|'VI'|'WF'|'EH'|'YE'|'ZM'|'ZW',
                        'PostalCode': 'string',
                        'StateOrRegion': 'string'
                    },
                    'CompanyName': 'string',
                    'Industry': 'Aerospace'|'Agriculture'|'Automotive'|'Computers and Electronics'|'Consumer Goods'|'Education'|'Energy - Oil and Gas'|'Energy - Power and Utilities'|'Financial Services'|'Gaming'|'Government'|'Healthcare'|'Hospitality'|'Life Sciences'|'Manufacturing'|'Marketing and Advertising'|'Media and Entertainment'|'Mining'|'Non-Profit Organization'|'Professional Services'|'Real Estate and Construction'|'Retail'|'Software and Internet'|'Telecommunications'|'Transportation and Logistics'|'Travel'|'Wholesale and Distribution'|'Other',
                    'OtherIndustry': 'string',
                    'WebsiteUrl': 'string'
                }
            },
            'Id': 'string',
            'LastModifiedDate': datetime(2015, 1, 1),
            'LifeCycle': {
                'ClosedLostReason': 'Customer Deficiency'|'Delay / Cancellation of Project'|'Legal / Tax / Regulatory'|'Lost to Competitor - Google'|'Lost to Competitor - Microsoft'|'Lost to Competitor - SoftLayer'|'Lost to Competitor - VMWare'|'Lost to Competitor - Other'|'No Opportunity'|'On Premises Deployment'|'Partner Gap'|'Price'|'Security / Compliance'|'Technical Limitations'|'Customer Experience'|'Other'|'People/Relationship/Governance'|'Product/Technology'|'Financial/Commercial',
                'NextSteps': 'string',
                'ReviewComments': 'string',
                'ReviewStatus': 'Pending Submission'|'Submitted'|'In review'|'Approved'|'Rejected'|'Action Required',
                'ReviewStatusReason': 'string',
                'Stage': 'Prospect'|'Qualified'|'Technical Validation'|'Business Validation'|'Committed'|'Launched'|'Closed Lost',
                'TargetCloseDate': 'string'
            },
            'OpportunityType': 'Net New Business'|'Flat Renewal'|'Expansion',
            'PartnerOpportunityIdentifier': 'string',
            'Project': {
                'DeliveryModels': [
                    'SaaS or PaaS'|'BYOL or AMI'|'Managed Services'|'Professional Services'|'Resell'|'Other',
                ],
                'ExpectedCustomerSpend': [
                    {
                        'Amount': 'string',
                        'CurrencyCode': 'USD'|'EUR'|'GBP'|'AUD'|'CAD'|'CNY'|'NZD'|'INR'|'JPY'|'CHF'|'SEK'|'AED'|'AFN'|'ALL'|'AMD'|'ANG'|'AOA'|'ARS'|'AWG'|'AZN'|'BAM'|'BBD'|'BDT'|'BGN'|'BHD'|'BIF'|'BMD'|'BND'|'BOB'|'BOV'|'BRL'|'BSD'|'BTN'|'BWP'|'BYN'|'BZD'|'CDF'|'CHE'|'CHW'|'CLF'|'CLP'|'COP'|'COU'|'CRC'|'CUC'|'CUP'|'CVE'|'CZK'|'DJF'|'DKK'|'DOP'|'DZD'|'EGP'|'ERN'|'ETB'|'FJD'|'FKP'|'GEL'|'GHS'|'GIP'|'GMD'|'GNF'|'GTQ'|'GYD'|'HKD'|'HNL'|'HRK'|'HTG'|'HUF'|'IDR'|'ILS'|'IQD'|'IRR'|'ISK'|'JMD'|'JOD'|'KES'|'KGS'|'KHR'|'KMF'|'KPW'|'KRW'|'KWD'|'KYD'|'KZT'|'LAK'|'LBP'|'LKR'|'LRD'|'LSL'|'LYD'|'MAD'|'MDL'|'MGA'|'MKD'|'MMK'|'MNT'|'MOP'|'MRU'|'MUR'|'MVR'|'MWK'|'MXN'|'MXV'|'MYR'|'MZN'|'NAD'|'NGN'|'NIO'|'NOK'|'NPR'|'OMR'|'PAB'|'PEN'|'PGK'|'PHP'|'PKR'|'PLN'|'PYG'|'QAR'|'RON'|'RSD'|'RUB'|'RWF'|'SAR'|'SBD'|'SCR'|'SDG'|'SGD'|'SHP'|'SLL'|'SOS'|'SRD'|'SSP'|'STN'|'SVC'|'SYP'|'SZL'|'THB'|'TJS'|'TMT'|'TND'|'TOP'|'TRY'|'TTD'|'TWD'|'TZS'|'UAH'|'UGX'|'USN'|'UYI'|'UYU'|'UZS'|'VEF'|'VND'|'VUV'|'WST'|'XAF'|'XCD'|'XDR'|'XOF'|'XPF'|'XSU'|'XUA'|'YER'|'ZAR'|'ZMW'|'ZWL',
                        'EstimationUrl': 'string',
                        'Frequency': 'Monthly',
                        'TargetCompany': 'string'
                    },
                ]
            }
        },
    ]
}

Response Structure

• (dict) –

  • NextToken (string) –

    A pagination token used to retrieve the next set of results in subsequent calls. This token is included in the response only if there are additional result pages available.

  • OpportunitySummaries (list) –

    An array that contains minimal details for opportunities that match the request criteria. This summary view provides a quick overview of relevant opportunities.

    • (dict) –

      An object that contains an Opportunity’s subset of fields.

      • Arn (string) –

        The Amazon Resource Name (ARN) for the opportunity. This globally unique identifier can be used for IAM policies and cross-service references.

      • Catalog (string) –

        Specifies the catalog associated with the opportunity, either AWS or Sandbox. This indicates the environment in which the opportunity is managed.

      • CreatedDate (datetime) –

        DateTime when the Opportunity was last created.

      • Customer (dict) –

        An object that contains the Opportunity’s customer details.

        • Account (dict) –

          An object that contains a customer’s account details.

          • Address (dict) –

            Specifies the end Customer’s address details associated with the Opportunity.

            • City (string) –

              Specifies the end Customer’s city associated with the Opportunity.

            • CountryCode (string) –

              Specifies the end Customer’s country associated with the Opportunity.

            • PostalCode (string) –

              Specifies the end Customer’s postal code associated with the Opportunity.

            • StateOrRegion (string) –

              Specifies the end Customer’s state or region associated with the Opportunity.

              Valid values: Alabama | Alaska | American Samoa | Arizona | Arkansas | California | Colorado | Connecticut | Delaware | Dist. of Columbia | Federated States of Micronesia | Florida | Georgia | Guam | Hawaii | Idaho | Illinois | Indiana | Iowa | Kansas | Kentucky | Louisiana | Maine | Marshall Islands | Maryland | Massachusetts | Michigan | Minnesota | Mississippi | Missouri | Montana | Nebraska | Nevada | New Hampshire | New Jersey | New Mexico | New York | North Carolina | North Dakota | Northern Mariana Islands | Ohio | Oklahoma | Oregon | Palau | Pennsylvania | Puerto Rico | Rhode Island | South Carolina | South Dakota | Tennessee | Texas | Utah | Vermont | Virginia | Virgin Islands | Washington | West Virginia | Wisconsin | Wyoming | APO/AE | AFO/FPO | FPO, AP

          • CompanyName (string) –

            Specifies the end Customer’s company name associated with the Opportunity.

          • Industry (string) –

            Specifies which industry the end Customer belongs to associated with the Opportunity. It refers to the category or sector that the customer’s business operates in.

            To submit a value outside the picklist, use Other.

            Conditionally mandatory if Other is selected for Industry Vertical in LOVs.

          • OtherIndustry (string) –

            Specifies the end Customer’s industry associated with the Opportunity, when the selected value in the Industry field is Other. This field is relevant when the customer’s industry doesn’t fall under the predefined picklist values and requires a custom description.

          • WebsiteUrl (string) –

            Specifies the end customer’s company website URL associated with the Opportunity. This value is crucial to map the customer within the Amazon Web Services CRM system.

      • Id (string) –

        Read-only, system-generated Opportunity unique identifier.

      • LastModifiedDate (datetime) –

        DateTime when the Opportunity was last modified.

      • LifeCycle (dict) –

        An object that contains the Opportunity’s lifecycle details.

        • ClosedLostReason (string) –

          Specifies the reason code when an opportunity is marked as Closed Lost. When you select an appropriate reason code, you communicate the context for closing the Opportunity, and aid in accurate reports and analysis of opportunity outcomes.

        • NextSteps (string) –

          Specifies the upcoming actions or tasks for the Opportunity. This field is utilized to communicate to Amazon Web Services the next actions required for the Opportunity.

        • ReviewComments (string) –

          Indicates why an opportunity was sent back for further details. Partners must take corrective action based on the ReviewComments.

        • ReviewStatus (string) –

          Indicates the review status of a partner referred opportunity. This field is read-only and only applicable for partner referrals. Valid values:

          • Pending Submission: Not submitted for validation (editable).

          • Submitted: Submitted for validation and not yet Amazon Web Services reviewed (read-only).

          • In Review: Undergoing Amazon Web Services validation (read-only).

          • Action Required: Address any issues Amazon Web Services highlights. Use the UpdateOpportunity API action to update the opportunity, and ensure you make all required changes. Only these fields are editable when the Lifecycle.ReviewStatus is Action Required:

            • Customer.Account.Address.City

            • Customer.Account.Address.CountryCode

            • Customer.Account.Address.PostalCode

            • Customer.Account.Address.StateOrRegion

            • Customer.Account.Address.StreetAddress

            • Customer.Account.WebsiteUrl

            • LifeCycle.TargetCloseDate

            • Project.ExpectedCustomerSpend.Amount

            • Project.ExpectedCustomerSpend.CurrencyCode

            • Project.CustomerBusinessProblem

            • PartnerOpportunityIdentifier

          After updates, the opportunity re-enters the validation phase. This process repeats until all issues are resolved, and the opportunity’s Lifecycle.ReviewStatus is set to Approved or Rejected.

          • Approved: Validated and converted into the Amazon Web Services seller’s pipeline (editable).

          • Rejected: Disqualified (read-only).

        • ReviewStatusReason (string) –

          Indicates the reason a specific decision was taken during the opportunity review process. This field combines the reasons for both disqualified and action required statuses, and provides clarity for why an opportunity was disqualified or required further action.

        • Stage (string) –

          Specifies the current stage of the Opportunity’s lifecycle as it maps to Amazon Web Services stages from the current stage in the partner CRM. This field provides a translated value of the stage, and offers insight into the Opportunity’s progression in the sales cycle, according to Amazon Web Services definitions.

          Note

          A lead and a prospect must be further matured to a Qualified opportunity before submission. Opportunities that were closed/lost before submission aren’t suitable for submission.

          The descriptions of each sales stage are:

          • Prospect: Amazon Web Services identifies the opportunity. It can be active (Comes directly from the end customer through a lead) or latent (Your account team believes it exists based on research, account plans, sales plays).

          • Qualified: Your account team engaged with the customer to discuss viability and understand requirements. The customer agreed that the opportunity is real, of interest, and may solve business/technical needs.

          • Technical Validation: All parties understand the implementation plan.

          • Business Validation: Pricing was proposed, and all parties agree to the steps to close.

          • Committed: The customer signed the contract, but Amazon Web Services hasn’t started billing.

          • Launched: The workload is complete, and Amazon Web Services has started billing.

          • Closed Lost: The opportunity is lost, and there are no steps to move forward.

        • TargetCloseDate (string) –

          Specifies the date when Amazon Web Services expects to start significant billing, when the project finishes, and when it moves into production. This field informs the Amazon Web Services seller about when the opportunity launches and starts to incur Amazon Web Services usage.

          Ensure the Target Close Date isn’t in the past.

      • OpportunityType (string) –

        Specifies opportunity type as a renewal, new, or expansion.

        Opportunity types:

        • New Opportunity: Represents a new business opportunity with a potential customer that’s not previously engaged with your solutions or services.

        • Renewal Opportunity: Represents an opportunity to renew an existing contract or subscription with a current customer, ensuring continuity of service.

        • Expansion Opportunity: Represents an opportunity to expand the scope of an existing contract or subscription, either by adding new services or increasing the volume of existing services for a current customer.

      • PartnerOpportunityIdentifier (string) –

        Specifies the Opportunity’s unique identifier in the partner’s CRM system. This value is essential to track and reconcile because it’s included in the outbound payload sent back to the partner. It allows partners to link an opportunity to their CRM.

      • Project (dict) –

        An object that contains the Opportunity’s project details summary.

        • DeliveryModels (list) –

          Specifies your solution or service’s deployment or consumption model in the Opportunity’s context. You can select multiple options.

          Options’ descriptions from the Delivery Model field are:

          • SaaS or PaaS: Your Amazon Web Services based solution deployed as SaaS or PaaS in your Amazon Web Services environment.

          • BYOL or AMI: Your Amazon Web Services based solution deployed as BYOL or AMI in the end customer’s Amazon Web Services environment.

          • Managed Services: The end customer’s Amazon Web Services business management (For example: Consulting, design, implementation, billing support, cost optimization, technical support).

          • Professional Services: Offerings to help enterprise end customers achieve specific business outcomes for enterprise cloud adoption (For example: Advisory or transformation planning).

          • Resell: Amazon Web Services accounts and billing management for your customers.

          • Other: Delivery model not described above.

          • (string) –

        • ExpectedCustomerSpend (list) –

          Provides a summary of the expected customer spend for the project, offering a high-level view of the potential financial impact.

          • (dict) –

            Provides an estimate of the revenue that the partner is expected to generate from the opportunity. This information helps partners assess the financial value of the project.

            • Amount (string) –

              Represents the estimated monthly revenue that the partner expects to earn from the opportunity. This helps in forecasting financial returns.

            • CurrencyCode (string) –

              Indicates the currency in which the revenue estimate is provided. This helps in understanding the financial impact across different markets.

            • EstimationUrl (string) –

              A URL providing additional information or context about the spend estimation.

            • Frequency (string) –

              Indicates how frequently the customer is expected to spend the projected amount. This can include values such as Monthly, Quarterly, or Annually. The default value is Monthly, representing recurring monthly spend.

            • TargetCompany (string) –

              Specifies the name of the partner company that is expected to generate revenue from the opportunity. This field helps track the partner’s involvement in the opportunity.

Exceptions

• PartnerCentralSellingAPI.Client.exceptions.ThrottlingException

• PartnerCentralSellingAPI.Client.exceptions.AccessDeniedException

• PartnerCentralSellingAPI.Client.exceptions.InternalServerException

• PartnerCentralSellingAPI.Client.exceptions.ValidationException

• PartnerCentralSellingAPI.Client.exceptions.ResourceNotFoundException