> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archeraffiliates.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List ASINs across the brands you own

> List the ASINs across the brands you own.

Each row carries the `asin`, its `brand_id` / `brand_name`, the `marketplace`
the product lives on, and an `active` flag telling you whether the product
is currently buyable on Amazon. Pass `asin` values to
`/sellers/reports?asins=…` to scope reporting to specific products.

### Filtering
- `search` — find products whose title or ASIN matches the given text.
- `brand_id` — restrict to a single brand you own. Ids come from `/sellers/brands`.
- `asins` — comma-separated ASINs to look up specific products.
- `marketplace` — restrict to a single Amazon marketplace, e.g.
  `amazon.co.uk`. Pass `all` or leave blank to include every marketplace.
- `active` — `true` only returns products that are currently buyable on
  Amazon (`is_active && !out_of_stock && !failing`). `false` returns
  only inactive ones. `both` (default) returns everything.

### Paging through results
Use `skip` and `limit` to page through the list. `total_count` is the total
across every page; `fetched_count` is how many you got back.



## OpenAPI

````yaml /docs/api-reference/sellers-openapi.json get /products
openapi: 3.1.0
info:
  title: Archer Sellers API
  description: |2-

        API for Archer brand owners (sellers).

        Use these endpoints to see how your brand's products are selling on
        Amazon, and how much commission you're paying out.

        ## Authentication

        All endpoints require authentication using JWT Bearer tokens.

        ### How to authenticate:
        1. Use the `/token` endpoint to obtain an access token with your username and password.
        2. Click the "Authorize" button at the top right.
        3. Enter your token in the format: `Bearer <your_access_token>`.
        4. Click "Authorize" to apply the token to all requests.
        
  version: '2.0'
servers:
  - url: https://api.archeraffiliates.com/sellers
    description: Production
security: []
paths:
  /products:
    get:
      tags:
        - Products
      summary: List ASINs across the brands you own
      description: >-
        List the ASINs across the brands you own.


        Each row carries the `asin`, its `brand_id` / `brand_name`, the
        `marketplace`

        the product lives on, and an `active` flag telling you whether the
        product

        is currently buyable on Amazon. Pass `asin` values to

        `/sellers/reports?asins=…` to scope reporting to specific products.


        ### Filtering

        - `search` — find products whose title or ASIN matches the given text.

        - `brand_id` — restrict to a single brand you own. Ids come from
        `/sellers/brands`.

        - `asins` — comma-separated ASINs to look up specific products.

        - `marketplace` — restrict to a single Amazon marketplace, e.g.
          `amazon.co.uk`. Pass `all` or leave blank to include every marketplace.
        - `active` — `true` only returns products that are currently buyable on
          Amazon (`is_active && !out_of_stock && !failing`). `false` returns
          only inactive ones. `both` (default) returns everything.

        ### Paging through results

        Use `skip` and `limit` to page through the list. `total_count` is the
        total

        across every page; `fetched_count` is how many you got back.
      operationId: get_seller_products_products_get
      parameters:
        - name: skip
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: How many products to skip — used for paging.
            default: 0
            title: Skip
          description: How many products to skip — used for paging.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            description: How many products to return per page (1–500). Defaults to 100.
            default: 100
            title: Limit
          description: How many products to return per page (1–500). Defaults to 100.
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Find products whose title or ASIN matches the given text.
            title: Search
          description: Find products whose title or ASIN matches the given text.
        - name: brand_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Restrict to a single brand you own. Ids come from
              `/sellers/brands`.
            title: Brand Id
          description: Restrict to a single brand you own. Ids come from `/sellers/brands`.
        - name: asins
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Limit results to one or more products by ASIN. Separate multiple
              ASINs with commas.
            title: Asins
          description: >-
            Limit results to one or more products by ASIN. Separate multiple
            ASINs with commas.
        - name: marketplace
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Restrict to one Amazon marketplace — e.g. `amazon.com`,
              `amazon.co.uk`. Use `all` or leave blank to include every
              marketplace.
            title: Marketplace
          description: >-
            Restrict to one Amazon marketplace — e.g. `amazon.com`,
            `amazon.co.uk`. Use `all` or leave blank to include every
            marketplace.
        - name: active
          in: query
          required: false
          schema:
            type: string
            description: >-
              Filter on the product's `active` flag — i.e. currently buyable on
              Amazon and good to promote. `true` returns only active products,
              `false` returns only inactive (out of stock / failing / paused).
              `both` (default) returns everything.
            enum:
              - 'true'
              - 'false'
              - both
            default: both
            title: Active
          description: >-
            Filter on the product's `active` flag — i.e. currently buyable on
            Amazon and good to promote. `true` returns only active products,
            `false` returns only inactive (out of stock / failing / paused).
            `both` (default) returns everything.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SellerProductsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    SellerProductsResponse:
      properties:
        total_count:
          type: integer
          title: Total Count
          description: Total products matching your filters across every page.
        fetched_count:
          type: integer
          title: Fetched Count
          description: Products in this page.
        skip:
          type: integer
          title: Skip
          description: The `skip` value that produced this page.
        limit:
          type: integer
          title: Limit
          description: The `limit` value that produced this page.
        products:
          items:
            $ref: '#/components/schemas/SellerProductRow'
          type: array
          title: Products
          description: The products on this page.
      type: object
      required:
        - total_count
        - fetched_count
        - skip
        - limit
        - products
      title: SellerProductsResponse
      description: The response from GET /sellers/products.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SellerProductRow:
      properties:
        asin:
          anyOf:
            - type: string
            - type: 'null'
          title: Asin
          description: The Amazon product identifier.
        product_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Product Name
          description: Product title.
        marketplace:
          anyOf:
            - type: string
            - type: 'null'
          title: Marketplace
          description: The Amazon marketplace the product belongs to, e.g. `amazon.co.uk`.
        brand_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Brand Id
          description: The brand the product belongs to.
        brand_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Brand Name
          description: Brand name as recorded on the row.
        commission_payout:
          anyOf:
            - type: string
            - type: 'null'
          title: Commission Payout
          description: >-
            Commission rate (percent) the brand pays out on a sale of this
            product, as a plain string. Source: `brand_commission_rate` on
            `products_catalog`.
        active:
          type: boolean
          title: Active
          description: >-
            True when the product is currently buyable on Amazon and good to
            promote.
          default: false
      type: object
      title: SellerProductRow
      description: One ASIN you own on the Archer platform.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: token

````