---
updatedAt: 2026-10-13T20:37:15.000Z
agentTools:
siteIndex: https://developer-docs.amazon/llms.txt
projectIndex: https://developer-docs.amazon/sp-api/llms.txt
---
# Selling Partner API Roles
Learn how to use roles in the Selling Partner API.
Roles are the mechanism by which the Selling Partner API (SP-API) determines whether a developer or application has access to an operation or resource. Roles protect access to personally identifiable information (PII) and other sensitive data, and ensure that developers only access data that their application requires.
As a developer, you must request and qualify for a particular role to gain access to the operations and resources that the role provides. If you call an operation for which you don't have the required roles, you get a 403 error.
## Choose your roles
Use the following topics to identify which role you need for each SP-API operation and type:
* [Role Mappings for Operations](https://developer-docs.amazon.com/sp-api/docs/role-mappings)
* [Role Mappings for Types](https://developer-docs.amazon.com/sp-api/docs/role-mappings-for-types)
After you know which roles you need, you request them through your developer profile. Amazon evaluates the information you submit and approves or denies your request. If denied, you can address the reason for the denial and then resubmit your profile.
### Add your approved roles to your application
When you [register your SP-API application](https://developer-docs.amazon.com/sp-api/docs/registering-your-application), you can choose roles from among those that you were approved for in your developer profile. If the role that you need is missing, you must update the roles in your developer profile to include the new role, and then resubmit your profile for evaluation by Amazon. If you are approved, the added role will be available to select for your application.
### Note
If you published a hybrid SP-API application, you must relist your application before reauthorization.
To add a new role:
1. Go to your developer profile and submit the role that you want to add.
2. After your [developer profile is approved](https://developer-docs.amazon.com/sp-api/docs/checking-the-status-of-your-request-to-register-as-a-developer), go to your application configuration and [apply the newly approved role](https://developer-docs.amazon.com/sp-api/docs/updating-your-application-information) to your application. Save the changes and re-list the application.
3. After the application is approved, [get new authorizations](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications) to generate a new refresh token that grants access to the API operations, reports, feeds, and notifications that the new role provides.
## Role definitions
In the following sections, *Restricted* means that the role requires sensitive information, which might include personally identifiable information (PII). For these roles, you must provide additional information about your data use and security controls.
### Account Information Service Provider
The Account Information Service Provider (AISP) role provides access to information about the Amazon Selling Partner account, including information about the seller's business and the Amazon stores where the seller account is active. You can use this role to view payment methods and financial events for the seller.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getAccount` operation of the [Sellers API v1](https://developer-docs.amazon.com/sp-api/reference/sellers-v1), which gets information about a seller account and its Amazon stores.
* The `getPaymentMethods` operation of the [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01), which returns a list of payment methods for the seller.
### Amazon Fulfillment
The Amazon Fulfillment role provides access to Amazon fulfillment operations and shipping services such as Fulfillment by Amazon (FBA) and Amazon Fulfillment Network (AFN). You generally use this role for FBA sales reports, order tracking reports, and operations related to order fulfillment.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the [FBA Fee Preview](https://developer-docs.amazon.com/sp-api/docs/report-type-values-fba#fba-fee-preview-report) report. This report contains the estimated Amazon selling and fulfillment fees for the seller's FBA inventory with active offers.
* The `getSubscription` operation of the [Notifications API v1](https://developer-docs.amazon.com/sp-api/reference/notifications-v1), when you subscribe to [`FBA_OUTBOUND_SHIPMENT_STATUS`](https://developer-docs.amazon.com/sp-api/docs/notification-type-values#fba_outbound_shipment_status) notifications. These notifications signify when Amazon creates or cancels a Fulfillment by Amazon shipment for a seller.
* The `listShipmentItems` operation of the [Fulfillment Inbound API v2024-03-20](https://developer-docs.amazon.com/sp-api/reference/fulfillment-inbound-v2024-03-20), which returns a list of packages in a shipment.
* The `createFeed` operation of the [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30), when you submit a `POST_FBA_INBOUND_CARTON_CONTENTS` feed. This feed lets you submit carton content information when shipping inventory to Amazonâs fulfillment network.
### Amazon Warehousing and Distribution
The Amazon Warehousing and Distribution (AWD) role provides access to AWD shipment and inventory operations. You generally use this role when you use the [Amazon Warehousing and Distribution API](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09) to interact with AWD inventory information and shipment details.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `listInventory` operation of the [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09), which returns inventory levels and states for products in AWD.
* The `getInboundShipment` operation of the [Amazon Warehousing and Distribution API v2024-05-09](https://developer-docs.amazon.com/sp-api/reference/amazon-warehousing-and-distribution-v2024-05-09), which returns shipment details such as the status and received quantities for reconciliation.
### Brand Analytics
The Brand Analytics role provides access to Amazon store analytics reports, such as seller and vendor performance metrics and consumer behavior insights that show how customers discover and purchase products on Amazon.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT` report. This report returns data on the top-clicked ASINs by search keyword and department for an Amazon store.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_PROMOTION_PERFORMANCE_REPORT` report. This report returns data from promotion campaigns to help vendors and sellers optimize their promotions and adjust their advertising strategies.
### Buyer Communication
The Buyer Communication role provides access to operations that manage messaging to and from Amazon buyers. You generally use this role when you use the [Messaging API](https://developer-docs.amazon.com/sp-api/reference/messaging-v1) to message Amazon buyers.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getMessagingActionsForOrder` operation of the [Messaging API v1](https://developer-docs.amazon.com/sp-api/reference/messaging-v1), which returns a list of message types available for a specified order.
* The `createConfirmOrderDetails` operation of the [Messaging API v1](https://developer-docs.amazon.com/sp-api/reference/messaging-v1), which sends a message to ask a buyer an order-related question prior to shipping.
* The `createConfirmDeliveryDetails` operation of the [Messaging API v1](https://developer-docs.amazon.com/sp-api/reference/messaging-v1), which sends a message to a buyer to arrange a delivery or confirm contact information for making a delivery.
### Buyer Solicitation
The Buyer Solicitation role provides access to buyer feedback solicitation operations. You generally use this role when you use the [Solicitations API](https://developer-docs.amazon.com/sp-api/reference/solicitations-v1) to solicit Amazon buyers for feedback.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getSolicitationActionsForOrder` operation of the [Solicitations API v1](https://developer-docs.amazon.com/sp-api/reference/solicitations-v1), which returns a list of solicitation types that are available for an order.
* The `createProductReviewAndSellerFeedbackSolicitation` operation of the [Solicitations API v1](https://developer-docs.amazon.com/sp-api/reference/solicitations-v1), which sends a solicitation to a buyer asking for feedback and a product review for an order.
### Direct-to-Consumer Shipping (Restricted)
The Direct-to-Consumer Shipping (Restricted) role provides access to operations that ship orders directly to customers using their carrier of choice, including Amazon. Operations that require this role use PII to enable shipping. You generally use this role to request order reports, order tracking reports, EasyShip, and for operations that relate to shipping orders placed on Amazon.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `getOrders` operation of the [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0), which returns a list of orders and order information based on criteria that you specify.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING` report.
* The `createFeed` operation of the [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30), when you submit a `POST_ORDER_FULFILLMENT_DATA` feed. This feed allows your system to update Amazon's system with order fulfillment information.
### Finance and Accounting
The Finance and Accounting role provides access to operations that create accounting and financial statements.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `getReports` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), to return a list of [Flat File V2 Settlement](https://developer-docs.amazon.com/sp-api/docs/report-type-values-settlement#flat-file-v2-settlement-report) reports.
* The `getSubscription` operation of the [Notifications API v1](https://developer-docs.amazon.com/sp-api/reference/notifications-v1), when you request information about subscriptions to the `FEE_PROMOTION` notification type.
### Inventory and Order Tracking
The Inventory and Order Tracking role provides access to operations that analyze and manage inventory. You generally use this role to get FBA sales reports, order tracking reports, and operations related to orders, vendor orders, sales order metrics, and inventory management. Operations that require this role do not use PII required to ship an order. Rather, this role is for applications that track shipments.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getOrderMetrics` operation of the [Sales API v1](https://developer-docs.amazon.com/sp-api/reference/sales-v1), which returns aggregated order metrics.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_MERCHANT_LISTINGS_DATA` report. This report returns detailed active listings.
* The `createFeed` operation of the [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30), when you submit a `POST_FLAT_FILE_FULFILLMENT_DATA` feed. This feed lets you submit order fulfillment information to Amazon.
### Notifications in Seller Central
The Notifications in Seller Central role provides access to operations that send targeted notifications to sellers within Seller Central. For example, you can use the [App Integrations API](https://developer-docs.amazon.com/sp-api/reference/app-integrations-v2024-04-01) to send notifications that inform the seller about their business or to encourage the seller to take action on your website.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `createNotification` operation of the [App Integrations API v2024-04-01](https://developer-docs.amazon.com/sp-api/reference/app-integrations-v2024-04-01) creates and sends a notification to sellers with information relevant to their business.
* The `deleteNotifications` operation of the [App Integrations API v2024-04-01](https://developer-docs.amazon.com/sp-api/reference/app-integrations-v2024-04-01) deletes a notification that was previously sent to a seller.
### Payment Initiation Service Provider
The Payment Initiation Service Provider (PISP) role provides access to operations that initiate the payout to the seller's deposit method and the issuance of a refund (adjustment) for an order.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `initiatePayout` operation of the [Transfers API v2024-06-01](https://developer-docs.amazon.com/sp-api/reference/transfers-v2024-06-01), which initiates an on-demand payout to the seller's default deposit method.
* The `createFeed` operation of the [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30), when you submit a `POST_FLAT_FILE_PAYMENT_ADJUSTMENT_DATA` feed.
### Pricing
The Pricing role provides access to operations that determine list prices and automate product pricing. You generally use this role for pricing-related reports, feeds, and operations.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getPricing` operation of the [Product Pricing API v2022-05-01](https://developer-docs.amazon.com/sp-api/reference/product-pricing-v2022-05-01), which returns pricing information for a seller's offer listings.
* The `createFeed` operation of the [Feeds API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/feeds-v2021-06-30), when you submit a `RFQ_UPLOAD_FEED` feed. This feed lets you upload quantity discounts in response to requests from business customers.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_MERCHANT_CANCELLED_LISTINGS_DATA` report. This report returns canceled listings.
### Product Listing
The Product Listing role provides access to operations that create and manage product listings. You generally use this role for product-catalog-related reports, feeds, and operations.
* **Role available to sellers?** Yes
* **Role available to vendors?** Yes
Select for examples of operations that require this role.
\- The `getCatalogItem` operation of the [Catalog Items API v2022-04-01](https://developer-docs.amazon.com/sp-api/reference/catalog-items-v2022-04-01), which returns information about the item indicated and its attributes.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_MERCHANT_LISTINGS_INACTIVE_DATA` report. This report returns detailed inactive listings.
* The `getMyFeesEstimateForSKU` operation of the [Product Fees API v0](https://developer-docs.amazon.com/sp-api/reference/product-fees-v0), which returns the estimated fees for the item indicated.
### Professional Services (Restricted)
The Professional Services (Restricted) role provides access to operations that provide add-on services such as assembly and installation to Amazon buyers. You generally use this role when you use the [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1).
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getServiceJobs` operation of the [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1), which returns a list of service job details for the specified filter query.
* The `addAppointmentForServiceJobByServiceJobId` operation of the [Services API v1](https://developer-docs.amazon.com/sp-api/reference/services-v1), which adds an appointment to the service job indicated by the service job identifier specified.
### Selling Partner Insights
The Selling Partner Insights role provides access to operations that retrieve information about a selling partner's account and performance.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getMarketplaceParticipations` operation of the [Sellers API v1](https://developer-docs.amazon.com/sp-api/reference/sellers-v1), which returns a list of Amazon stores that a seller can sell in, and information about the seller's participation in those Amazon stores.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_V1_SELLER_PERFORMANCE_REPORT` report. This report contains individual performance metrics from the Seller Central dashboard.
### Selling Partner Support (Restricted)
The Selling Partner Support (Restricted) role grants approved applications access to a selling partner's Amazon support case data. Use this role to retrieve, search, and manage support cases outside of Seller Central, or to display case details in a selling partner's workflow.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getCase` operation of the [Support API v2025-02-01](https://developer-docs.amazon.com/sp-api/reference/support-v2025-02-01), which returns the details of a single support case.
* The `listCases` operation of the [Support API v2025-02-01](https://developer-docs.amazon.com/sp-api/reference/support-v2025-02-01), which returns a seller's support cases.
* The `listContacts` operation of the [Support API v2025-02-01](https://developer-docs.amazon.com/sp-api/reference/support-v2025-02-01), which returns the contact history for a support case.
### Tax Invoicing (Restricted)
The Tax Invoicing (Restricted) role provides access to operations that generate tax invoices to comply with tax regulation. Operations that require this role require PII to enable tax invoice generation. You generally use this role for tax reports, order reports, and operations that return information about orders.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getOrderBuyerInfo` operation of the [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0), which returns buyer information for an order.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT` report.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_EASYSHIP_DOCUMENTS` report. This report contains the invoice, shipping label and warranty documents for an Easy Ship order.
### Tax Remittance (Restricted)
The Tax Remittance (Restricted) role provides access to operations that calculate and remit sales taxes. Operations that require this role might use PII to calculate sales taxes. You generally use this role for FBA sales reports, order reports, and operations that return information about orders.
* **Role available to sellers?** Yes
* **Role available to vendors?** No
Select for examples of operations that require this role.
\- The `getOrderItems` operation of the [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0), which returns detailed item information for an order.
* The `getOrderAddress` operation of the [Orders API v0](https://developer-docs.amazon.com/sp-api/reference/orders-v0), which returns the shipping address for an order.
* The `createReport` operation of the [Reports API v2021-06-30](https://developer-docs.amazon.com/sp-api/reference/reports-v2021-06-30), when you request the `GET_ORDER_REPORT_DATA_TAX` report.