List products - Seller Assistant API

Filters use filter[field][operator]=value. Several filters narrow each other.

Field	Operators	Example
`id`	eq, in	`filter[id][in]=P-5XK1S0NQNO,P-IQGFRCLHKT`
`asin`, `upc`, `ean`, `title`, `note`	eq, like, nlike, null	`filter[title][like]=catan`
`brand`, `marketplace`, `default_supplier`, `other_supplier`, `tag`	eq, in, ne, nin, null	`filter[brand][in]=Catan`
`default_cog`, `other_cog`, `total_stock`	eq, ne, gte, lte, between	`filter[total_stock][between]=10,50`
`preference` (`like`, `dislike`), `listing_status` (`active`, `inactive`, `error`, `no_listing`)	eq, in, ne, nin	`filter[listing_status][eq]=active`

The name filters take the name, not the id. GET /api/v1/sa/inventory/products/filter-options gives the brands, the marketplaces and the suppliers of the team. GET /api/v1/tags gives the tags. The note filter reads the notes of the product ASINs. /api/v1/notes with target_type=asin reads and writes them. The target_id is <marketplace_code>/<identifier> of a match. The user sets the preference value in the Seller Assistant app. The API does not show or change it. An unknown field or operator answers 400.

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

One page of the products

Bodyapplication/json

Example

{
    "data": [
        {
            "id": "P-5XK1S0NQNO",
            "title": "Catan Board Game",
            "brand": "Catan",
            "image_url": "https://m.media-amazon.com/images/I/51N-u8AsmdL.jpg",
            "package_quantity": 2,
            "default_supplier_id": 10,
            "total_stock": 12,
            "tags": [
                3
            ],
            "matches": [
                {
                    "platform": "amazon",
                    "marketplace_code": "ATVPDKIKX0DER",
                    "identifier": "B00U26V4VQ",
                    "identifier_type": "asin",
                    "title": "External Product Title"
                }
            ],
            "created_at": "2026-05-16T15:09:58Z",
            "updated_at": "2026-05-16T15:09:58Z"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 137,
            "last_page": 6
        },
        "trial_limit": {
            "max_rows": 25,
            "total": 137,
            "code": "trial_list_limited",
            "message": "The trial shows only the first rows of a list. Subscribe to see all rows.",
            "subscribe_url": "https://app.sellerassistant.app/subscription"
        }
    }
}

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠422BusinessLogicError

🟠429TooManyRequests