GET /v3/vendor/activity — activity feed

GET

/v3/vendor/activity

const url = 'https://api-ha-prod-p8.handbid.dev/v3/vendor/activity?since=1893456000&eventType=sold&limit=100';
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/activity?since=1893456000&eventType=sold&limit=100' \
  --header 'Authorization: Bearer <token>'

Activity feed across your vendor catalog — reservations, pulls, and sales. On a sold event, sale carries salePrice, costOwed, and a winnerContact note.

Winner PII is deliberately NOT in this feed. The winner’s name, email, and phone are delivered out-of-band via the fulfillment email and the sales-report CSV — never in this JSON — so partner integrations can’t accumulate bidder PII.

Query: since (epoch), eventType (filter to one type), limit (default 100, capped at 200).

Errors: 401 / 403 as elsewhere.

Authorizations

bearer

Parameters

Query Parameters

since

integer

Only events at or after this epoch timestamp.

Example

1893456000

eventType

string

Filter to a single event type (e.g. sold, reserved, pulled).

Example

sold

limit

integer

Default 100, capped at 200.

Example

Responses

200

The vendor activity feed.

application/json

object

Example

{
  "activity": [
    {
      "productId": 5001,
      "eventType": "sold",
      "auctionId": 555,
      "itemId": 7001,
      "sale": {
        "salePrice": 3200,
        "costOwed": 2000,
        "winnerContact": "Delivered via the fulfillment email and sales-report CSV."
      }
    }
  ]
}

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."
}