Changelog

Versioning

The public REST API is versioned in the URL path (/api/v1/...). The current version is 1, as declared in the OpenAPI spec.

Breaking changes to the v1 contract will be announced here before they take effect. New endpoints and additive response fields may ship without a version bump.

Base URL

https://hgvtraders.com/api/v1

Release history

v1.1 — dealer write API

Added bearer-authenticated dealer routes:

• Stock: list, create, update, publish, unpublish, sold
• Uploads: direct multipart image upload (POST /api/v1/uploads, max 4MB) and presigned upload for larger files
• Jobs (dealer): create, update, publish, unpublish; bearer GET /api/v1/jobs lists org jobs
• Enquiries: list and detail (buyer contact fields)

See Stock, Jobs (dealer), and Enquiries.

v1 — initial public API

• Public read: GET /api/v1/jobs, /events, /posts (list + detail)
• Bearer: POST /api/v1/auth, GET /api/v1/me, GET/PATCH /api/v1/accounts, POST /api/v1/notification_tokens
• Outbound webhooks: enquiry, stock lifecycle, and job application events