Seller Assistant API
Home
Seller AssistantHelp CenterAccount
Home
Seller AssistantHelp CenterAccount
Get API Keys
  1. Profitability
  • Introduction
  • Authentication
  • Throttling
  • Error Handling
  • Swagger Documentation
  • Amazon SP-API Marketplace IDs
  • Amazon Marketplace Categories
  • Products
    • Get product info
      GET
    • Get product statistics
      GET
    • Calculate product profit
      POST
  • UPC-EAN-ASIN converters
    • Get product ASINs based on identifiers (UPC or EAN)
      GET
    • Get product identifiers (UPC, EAN, etc.) based on ASIN
      GET
  • Restrictions
    • Check ASIN restrictions
      GET
  • Sales Estimation
    • Estimate sales by ASIN
      GET
    • Estimate sales by BSR and category
      POST
  • Keepa
    • Get Keepa product
      GET
    • Search Keepa products
      GET
    • Keepa Product Finder
      POST
  • FBA Inbound Shipments
    • Summary
    • List inbound plans
      GET
    • Get inbound plan
      GET
    • List inbound plan boxes
      GET
    • List plan shipments
      GET
    • Get shipment
      GET
    • List shipment items
      GET
    • Get shipment fees
      GET
    • List shipment boxes
      GET
  • Listings Items
    • Search listings items
    • Get listings item
    • Create or update listing from ASIN
    • Delete listings item
  • SP-API FBA Shipments
    • Get old shipments
    • Get old shipment items
    • Get old shipment items by old shipment id
    • List inbound plans
    • Get inbound plan
    • List inbound plan boxes
    • List placement options
    • List transportation options
    • Get shipment
    • List shipment items
    • List shipment boxes
    • List packing options
    • List packing group boxes
    • List packing group items
  • SP-API FBA Inventory
    • Get inventory summaries
  • SP-API Catalog Items
    • Search catalog items
    • Get catalog item
  • SP-API Listings Items
    • Search listings items
    • Get listings item
    • Put listings item
    • Delete listings item
    • Patch listings item
  • SP-API Product Type Definitions
    • Search definitions product types
    • Get a product type definition
  • SP-API Product Pricing
    • Get competitive pricing
    • Get competitive summary for ASINs
  • Documents (Beta)
    • List the documents of the team
    • Upload a document and hang it on a purchase order or on a supplier
    • Delete several documents
    • Get one document
    • Delete a document
    • Set the type of a document, or turn its import offer off
    • Get a link that reads the file
    • Read what the parser found in an invoice
    • Write the confirmed invoice lines into the purchase order
  • Account (Beta)
    • Get current user info
    • Get the caller, the team, the plan, the marketplaces, the quotas and the flags
  • Notes (Beta)
    • List the notes on one thing
    • Write a note on one thing
    • Delete several notes
    • Delete a note
    • Change the text of a note
  • Price List Analyzer
    • Start a price list analysis, from a file or from already-mapped JSON items
    • Get price list processing status
    • Get price list results (paginated)
    • Update calculations for a single price list item
    • Update expenses configuration for a price list
  • SA Inventory Product History (Beta)
    • Get history for internal product
    • Get history for all products in team
    • Get available history action types
  • SA Inventory Products (Beta)
    • List the values the filters of the product list accept
    • Autocomplete products from multiple sources for internal product creation
    • Create internal product
    • List the products of the team
    • Delete several products
    • Get internal product
    • Create or update product supplier offer
    • Delete one product
    • Delete product supplier offer
    • Update internal product
    • List external product identifiers
    • List product supplier offers
    • Set the matches of one product
    • Remove some matches of one product
  • SA Inventory Listings (Beta)
    • List the listings of the team
    • Make one listing draft, or several
    • Delete several listings
    • Get one listing
    • Delete one listing draft
  • SA Inventory Purchase Orders (Beta)
    • List the purchase orders of the team
    • Create a purchase order
    • Delete several purchase orders
    • Get one purchase order
    • Delete one purchase order
    • Change a purchase order
    • List the items of one purchase order
    • Add items to a purchase order
    • Search the items of every purchase order of the team
    • Delete several items of purchase orders
    • Delete one purchase order item
    • Change one item of a purchase order
  • SA Inventory SKUs (Beta)
    • List the SKUs of the team
    • Delete several SKUs
    • Get one SKU
    • Delete one SKU
    • Set the costs of a SKU, or link it to a purchase order line
  • SA Inventory Suppliers (Beta)
    • List suppliers
    • Create supplier
    • Delete several suppliers
    • Get supplier
    • Delete supplier
    • Update supplier
    • Get all supplier offers for a specific supplier
  • SA Inventory Warehouses (Beta)
    • List the warehouses the team can use
    • Create a warehouse
    • Delete several warehouses
    • Get one warehouse
    • Delete one warehouse
    • Change a warehouse
    • List the prep providers a warehouse can sync with
  • SA Repricer (Beta)
    • Get repricer history for a product (all repricing runs)
    • Get aggregate repricer history statistics for the team
    • Reset the team's repricer settings to global defaults
    • Get an overview context for repricing, including team settings, allowed marketplaces, and usage limits
    • Update the global repricer settings for the current team
    • Get the current team's global repricer settings
    • List the values the filters of the repricer list accept
    • Remove one product from the repricer or several
    • Update one repricer product or several
    • List all repricing strategies for the current team
    • Get a paginated list of repricer products for the current team
    • Create a new repricing strategy
    • Create a new repricer product
    • Delete several strategies
    • Get a single repricing strategy by ID
    • Delete a repricing strategy
    • Get a single repricer product by ID
    • Update a repricing strategy
    • Delete one repricer product
    • Assign a strategy to products
    • Update one repricer product
    • Run repricing for a single product
  • Tags (Beta)
    • List the tags of the team
    • Create a tag
    • Delete several tags
    • Delete a tag
    • Change the name or the colour of a tag
    • Put a tag on products, or take it off them
  • Profitability
    • Get account-level profitability summary
      GET
    • Get daily profitability timeseries
      GET
    • Get per-SKU profitability (paginated)
      GET
    • Get single-SKU P&L + timeseries
      GET
    • Get paginated raw orders
      GET
  • Schemas
    • Schemas
      • ApiError
      • CheckAsinRestrictionsRequest
      • EstimateSalesRequest
      • AmazonSellerAccountRequiredApiError
      • InternalApiError
      • EstimateSalesByAsinRequest
      • ProductResponse
      • DangerBrand
      • ProductDefect
      • Category
      • Variation
      • Marketplace
      • Urls
      • Price
      • Size
      • ProductPriceCurrency
      • Risks
      • Offers
      • FbaDetails
    • BadRequestApiError
    • ConvertToASINResponseItem
    • AccessDeniedApiError
    • PaymentRequiredApiError
    • ConvertToASINResponse
    • ResourceNotFoundApiError
    • ConvertToASINInternalApiError
    • TooManyRequestsApiError
    • GetProductIdentifiersResponseItem
    • GetProductIdentifiersResponse
    • GetProductIdentifiersInternalApiError
    • ListPlanShipmentsResponse
    • Document
    • ListPlanShipmentsInternalApiError
    • ProductNotFoundApiError
    • GetShipmentFeesResponse
    • GetShipmentFeesInternalApiError
    • KeepaProductStats
    • KeepaProductCsv
    • KeepaProductOffer
    • KeepaProduct
    • GetKeepaProductInternalApiError
    • SearchKeepaProductsResponse
    • SearchKeepaProductsInternalApiError
    • QueryKeepaProductsResponse
    • SearchInsightsObject
    • QueryKeepaProductsInternalApiError
    • PutListingsItemRequest
    • PutListingsItemInternalApiError
    • Currency
    • Product
    • Quota
    • ProductBsr
    • FeatureFlag
    • ProductCategory
    • Note
    • ProductVariations
    • NoteForm
    • ProductVariation
    • PriceListAnalyzerUploadResponse
    • ProductMarketplace
    • PriceListAnalyzerJsonItem
    • ProductUrls
    • PriceListAnalyzerStatusResponse
    • ProductPrices
    • ProductSize
    • ProductRisks
    • ProductOffers
    • ProductFees
    • GetProductInternalApiError
    • CalculateProductProfitRequest
    • BusinessLogicApiError
    • ProductProfit
    • CalculateProductProfitInternalApiError
    • ProductStats
    • GetProductStatsInternalApiError
    • CheckAsinRestrictionsResponse
    • CheckRestrictionsInternalApiError
    • ExternalProduct
    • ExternalProductUpsertItem
    • SupplierProductOffer
    • InternalProduct
    • ProductMatch
    • ProductSupplierOffer
    • ProductMatchItem
    • InternalProductForm
    • ApiSaRepricerSettingsController
    • ListingForm
    • Listing
    • PurchaseOrder
    • PurchaseOrderCreateForm
    • CurrentUserInfoResponse
    • PurchaseOrderForm
    • PurchaseOrderItemForm
    • EstimateSalesInternalApiError
    • PurchaseOrderItem
    • EstimateSalesResponse
    • Sku
    • EstimateSalesByBsrRequest
    • Supplier
    • SearchCatalogItemsResponse
    • SupplierOffer
    • CatalogItemsPagination
    • CreateSupplierForm
    • Refinements
    • UpdateSupplierForm
    • BrandRefinement
    • WarehouseForm
    • ClassificationRefinement
    • Warehouse
    • CatalogItem
    • WarehouseProvider
    • CatalogItemBrowseClassificationsByMarketplace
    • RepricerProductHistoryItem
    • CatalogItemBrowseClassification
    • HistorySearchResponse
    • CatalogItemDimensionsByMarketplace
    • HistoryStats
    • Dimensions
    • RepricerDefaultSettings
    • Dimension
    • RepricerInfo
    • CatalogItemIdentifiersByMarketplace
    • RepricerSettings
    • CatalogItemIdentifier
    • UpdateRepricerSettings
    • CatalogItemImagesByMarketplace
    • RepricerProduct
    • CatalogItemImage
    • RepricerProductListResponse
    • CatalogItemProductTypeByMarketplace
    • CreateRepricerProductForm
    • CatalogItemRelationshipsByMarketplace
    • UpdateRepricerProductForm
    • CatalogItemRelationship
    • RepricerStrategy
    • CatalogItemVariationTheme
    • RepricerStrategyForm
    • CatalogItemSalesRanksByMarketplace
    • Tag
    • CatalogItemClassificationSalesRank
    • TagForm
    • CatalogItemDisplayGroupSalesRank
    • GetCurrentUserInfoInternalApiError
    • CatalogItemSummaryByMarketplace
    • CatalogItemContributor
    • ApiV1Pagination
    • CatalogItemContributorRole
    • ApiV1BatchMeta
    • CatalogItemVendorDetailsByMarketplace
    • ApiV1BatchError
    • CatalogItemVendorDetailsCategory
    • SearchCatalogItemsInternalApiError
    • GetCatalogItemInternalApiError
    • GetInventorySummariesResponse
    • GetInventorySummariesResult
    • InventoryPagination
    • Granularity
    • InventorySummary
    • InventoryDetails
    • ReservedQuantity
    • ResearchingQuantity
    • ResearchingQuantityEntry
    • UnfulfillableQuantity
    • GetInventorySummariesInternalApiError
    • SpApiMoney
    • ShipmentAddress
    • OldShipment
    • GetShipmentsResponse
    • GetShipmentsInternalApiError
    • OldShipmentItem
    • GetShipmentItemsResponse
    • GetShipmentItemsInternalApiError
    • GetShipmentItemsByShipmentIdResponse
    • GetShipmentItemsByShipmentIdInternalApiError
    • ListInboundPlansResponse
    • InboundPlanSummary
    • Address
    • ListInboundPlansInternalApiError
    • GetInboundPlanResponse
    • GetInboundPlanInternalApiError
    • ListPlacementOptionsResponse
    • PlacementOption
    • Incentive
    • CurrencyValue
    • ListPlacementOptionsInternalApiError
    • TransportationOption
    • ListTransportationOptionsResponse
    • ListTransportationOptionsInternalApiError
    • ShipmentSummary
    • GetShipmentInternalApiError
    • ShipmentItem
    • PrepInstruction
    • ListShipmentItemsResponse
    • ListShipmentItemsInternalApiError
    • ListInboundPlanBoxesResponse
    • Box
    • Region
    • BoxDimensions
    • BoxWeight
    • ListInboundPlanBoxesInternalApiError
    • ListShipmentBoxesResponse
    • ListShipmentBoxesInternalApiError
    • ListPackingOptionsResponse
    • PackingOption
    • PackingConfiguration
    • BoxRequirements
    • WeightRange
    • ShippingRequirements
    • ShippingConfiguration
    • ListPackingOptionsInternalApiError
    • ListPackingGroupBoxesResponse
    • ListPackingGroupBoxesInternalApiError
    • ListPackingGroupItemsResponse
    • ListPackingGroupItemsInternalApiError
    • SearchListingsItemsResponse
    • Pagination
    • CurrencyAmount
    • Points
    • Image
    • VariationTheme
    • ListingsItemSummary
    • ListingsItemIssue
    • Enforcements
    • EnforcementAction
    • Exemption
    • ListingsItemIdentifier
    • ListingOfferPrice
    • OfferAudience
    • FulfillmentAvailability
    • Procurement
    • ProductRelationship
    • MarketplaceRelationship
    • ProductTypeDefinition
    • ListingsItem
    • SearchListingsItemsInternalApiError
    • GetListingsItemInternalApiError
    • ListingsItemPutRequest
    • ListingsItemSubmissionResponse
    • ListingsItemPatchRequest
    • PatchListingsItemInternalApiError
    • DeleteListingsItemInternalApiError
    • ProductType
    • ProductTypeListResponse
    • SearchProductTypeDefinitionsInternalApiError
    • ProductTypeDefinitionResponse
    • ProductTypeVersion
    • Link
    • SchemaLink
    • PropertyGroup
    • ProductTypeDefinitionsInternalApiError
    • CompetitivePricingError
    • CompetitivePricingProduct
    • CompetitivePricingItem
    • CompetitivePricingResponse
    • CompetitiveSummaryError
    • CompetitiveSummaryResponse
  1. Profitability

Get account-level profitability summary

GET
https://app.sellerassistant.app/api/v1/sa/profitability/summary
Account-level P&L summary for a marketplace and period: revenue, units, fees, COGS, profit. While the ~90-day sales backfill is still running, falls back to account-level revenue/units from Amazon GetOrderMetrics (meta.source=amazon_order_metrics); once backfill completes, serves the full ledger (meta.source=ledger). Pass compare=previous_period to get current + previous + delta in one call.

Request

Authorization
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.sellerassistant.app/api/v1/sa/profitability/summary?marketplace_id=ATVPDKIKX0DER&period=30d&from=2026-06-01&to=2026-06-30&compare=previous_period&api_key=%3Capi-key%3E'

Responses

🟢200
Successful response
This response does not have a body.
🟠400BadRequest
🟠402PaymentRequired
🟠403AccessDenied
🟠422BusinessLogicError
🟠429TooManyRequests
Modified at 2026-09-29 10:19:11
Previous
Put a tag on products, or take it off them
Next
Get daily profitability timeseries
Built with