GET /v3/vendor/products — list catalog

GET

/v3/vendor/products

const url = 'https://api-ha-prod-p8.handbid.dev/v3/vendor/products?q=napa&status=available&taxonomyId=12';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-ha-prod-p8.handbid.dev/v3/vendor/products?q=napa&status=available&taxonomyId=12' \
  --header 'Authorization: Bearer <token>'

List the marketplace packages in your own vendor catalog. The Bearer token’s organization must be a marketplace vendor.

Query filters (all optional, AND-combined):

q — keyword; substring over product name / productCode.
status — filter by lifecycle status (e.g. available).
taxonomyId — filter to one marketplace taxonomy category.

Response (200): a direct object — { products: [...] }. Each card carries reservedCount (how many live auction items currently hold the package) alongside inventoryQuantity.

Errors: 401 unauthorized (missing/invalid token), 403 forbidden (the token’s org is not a marketplace vendor).

Authorizations

bearer

Parameters

Query Parameters

string

Keyword — substring over product name and productCode.

Example

napa

status

string

Filter by lifecycle status.

Example

available

taxonomyId

integer

Filter to one marketplace taxonomy category.

Example

Responses

200

The vendor’s catalog.

application/json

object

Example

{
  "products": [
    {
      "id": 5001,
      "productCode": "WIN-1",
      "name": "Napa Getaway",
      "status": "available",
      "isPublic": true,
      "cost": 2000,
      "retailValue": 4500,
      "inventoryQuantity": 3,
      "reservedCount": 1,
      "taxonomyId": 12,
      "imageUrl": null
    }
  ]
}

401

No or invalid Bearer token.

application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object

error

required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string

message

required

Human-readable explanation.

string

retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer

Example

{
  "error": "unauthorized",
  "message": "A valid Bearer token is required."
}

403

The token’s organization is not a marketplace vendor.

application/json

Unified error envelope. retryAfter is present only on transient (429 / 503) responses.

object

error

required

Stable machine-readable error code (e.g. unauthorized, forbidden, not_found, validation_error, unavailable).

string

message

required

Human-readable explanation.

string

retryAfter

Seconds to wait before retrying. Present on 429 and 503.

integer

Example

{
  "error": "forbidden",
  "message": "Your organization is not a marketplace vendor."
}