REST API and webhooks

Bidyear exposes a versioned REST API at /api/v1 for building integrations, syncing data, and automating auction workflows. The full OpenAPI specification is available at /docs/api.

Key API resources

1. GET /api/v1/auctions — list active auctions with filters.
2. GET /api/v1/lots — list lots; filter by auction, status, acreage.
3. POST /api/v1/bids — place a bid programmatically.
4. GET /api/v1/invoices — retrieve invoices for your account.
5. GET /api/v1/me — authenticated user profile and capabilities.

Webhooks

Subscribe to real-time events by registering an HTTPS endpoint at /account/developer/webhooks. Events include: lot.bid_placed, lot.sold, lot.passed, invoice.created, invoice.paid, auction.started, auction.ended.

Authentication

All API requests require a Bearer token in the Authorization header. Generate tokens at /account/developer/tokens.

Reference docs

• API documentation
• API tokens
• Webhook subscriptions

Last updated: 2026-07-12