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

# List products

> List products belonging to the authenticated merchant



## OpenAPI

````yaml https://api.auctionnow.io/api/alpha/doc get /alpha/merchant/products
openapi: 3.0.0
info:
  version: alpha
  title: Auction Now API
servers:
  - url: https://api.auctionnow.io/api
    description: Production API
security: []
paths:
  /alpha/merchant/products:
    get:
      tags:
        - Products
      summary: List products
      description: List products belonging to the authenticated merchant
      parameters:
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              Filter by whether the product has an active auction. When false,
              only standalone products are returned.
          required: false
          description: >-
            Filter by whether the product has an active auction. When false,
            only standalone products are returned.
          name: hasActiveAuction
          in: query
        - schema:
            type: string
            description: Your Auction Now API key as a Bearer token
            example: Bearer ak_XXXXXXX
          required: true
          description: Your Auction Now API key as a Bearer token
          name: Authorization
          in: header
      responses:
        '200':
          description: A successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: Auction Now's unique identifier for the product
                        _creationTime:
                          type: number
                          description: >-
                            The time when the product was created, in
                            milliseconds since the Unix epoch
                        title:
                          type: string
                          description: The product title
                        description:
                          type: string
                          description: The product description
                        price:
                          type: number
                          description: The product price in USD
                        slug:
                          type: string
                          description: >-
                            A unique, human-readable, url-safe identifier for
                            the product
                        handle:
                          type: string
                          description: A human-readable identifier for the product
                        partyId:
                          type: string
                          description: A unique identifier for your merchant account
                        quantity:
                          type: number
                          description: Total units available
                        quantityAvailable:
                          type: number
                          description: Number of units still available for purchase
                        shippingCostUS:
                          type: number
                          description: Domestic (US) shipping cost in USD
                        shippingCostInternational:
                          type: number
                          description: International shipping cost in USD
                        status:
                          type: string
                          description: >-
                            Current product status (INSTOCK, SCHEDULED,
                            OUTOFSTOCK, DRAFT)
                        productType:
                          type: string
                          enum:
                            - PHYSICAL
                            - DIGITAL_FILE
                            - DIGITAL_LINK
                          description: The type of product
                        type:
                          type: string
                          enum:
                            - AUCTION_AND_PRODUCT
                            - PRODUCT_ONLY
                          description: Whether this product is linked to an auction
                        image:
                          type: string
                          description: URL of the primary product image
                        digitalLink:
                          type: string
                          description: The digital link URL, if applicable
                        customMessage:
                          type: string
                          description: Custom message for digital product delivery
                        url:
                          type: string
                          description: >-
                            The URL of the product on your AuctionNow.io
                            storefront
                        isArchived:
                          type: boolean
                          description: Whether this product is archived (hidden)
                      required:
                        - _id
                        - _creationTime
                        - title
                        - description
                        - slug
                        - handle
                        - partyId
                    description: A list of products
                  message:
                    type: string
                  timestamp:
                    type: number
                required:
                  - data
                  - timestamp
        '400':
          description: Bad Request - Validation error or invalid input
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  error:
                    anyOf:
                      - type: string
                      - type: object
                        properties:
                          errors:
                            type: array
                            items:
                              type: string
                          properties:
                            type: object
                            properties:
                              data:
                                type: object
                                properties:
                                  errors:
                                    type: array
                                    items:
                                      type: string
                                  properties:
                                    type: object
                                    additionalProperties:
                                      type: object
                                      properties:
                                        errors:
                                          type: array
                                          items:
                                            type: string
                                      required:
                                        - errors
                                required:
                                  - errors
                                  - properties
                            required:
                              - data
                        required:
                          - errors
                          - properties
                required:
                  - message
                  - error
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  reason:
                    type: string
                required:
                  - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  reason:
                    type: string
                required:
                  - error
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error

````