API Documentation

Integrate WatchDealerInventory with your applications using our comprehensive REST API

Get API Access View Integrations

Quick Start

Get up and running with our API in minutes

Base URL

https://wdi-api.onrender.com/api

Authentication

Include your API key in the Authorization header:

Authorization: Bearer your_api_key

Example Request

Get your inventory items:

curl -H "Authorization: Bearer your_api_key" \
    https://wdi-api.onrender.com/api/inventory

API Endpoints

Comprehensive reference for all available endpoints

GET/api/inventory

Retrieve inventory items

Parameters

Parameter	Type	Required	Description
page	number	No	Page number for pagination
limit	number	No	Number of items per page
status	string	No	Filter by status (available, sold, reserved)

Example

GET /api/inventory?page=1&limit=20&status=available

POST/api/inventory

Create a new inventory item

Parameters

Parameter	Type	Required	Description
make	string	Yes	Watch manufacturer
model	string	Yes	Watch model name
reference	string	Yes	Reference number
price	number	Yes	Asking price
condition	string	Yes	Watch condition

Example

POST /api/inventory

GET/api/deals

Retrieve B2B deals and transactions

Parameters

Parameter	Type	Required	Description
status	string	No	Deal status filter
dealer_id	string	No	Filter by dealer ID

Example

GET /api/deals?status=pending

POST/api/deals

Create a new B2B deal

Parameters

Parameter	Type	Required	Description
buyer_id	string	Yes	Buyer dealer ID
seller_id	string	Yes	Seller dealer ID
items	array	Yes	Array of item IDs
offer_price	number	Yes	Offer price

Example

POST /api/deals

GET/api/public-links

Generate public sharing links for inventory

Parameters

Parameter	Type	Required	Description
item_id	string	Yes	Inventory item ID
expires_in	number	No	Link expiration in hours

Example

GET /api/public-links?item_id=123&expires_in=24

Authentication Methods

Choose the authentication method that works best for your application

API Key Authentication

Use your API key in the Authorization header

Authorization: Bearer your_api_key_here

OAuth 2.0

Use OAuth 2.0 for secure authentication

Authorization: Bearer oauth_access_token

Rate Limits

Fair usage policies to ensure optimal performance for all users

Free Plan

Perfect for testing and small applications

100 requests/hour

Professional Plan

Ideal for growing businesses

1,000 requests/hour

Enterprise Plan

For high-volume applications

10,000 requests/hour

SDKs & Libraries

Official libraries and community tools to help you integrate faster

JavaScript SDK

Official JavaScript/Node.js SDK for easy integration

Get SDK →

Python SDK

Python library for data analysis and automation

Get SDK →

Postman Collection

Ready-to-use API collection for testing and development

Get Collection →

Need Help with Integration?

Our developer support team is here to help you integrate successfully. Get in touch for technical assistance, custom integrations, or API questions.

Contact Developer Support Browse Help Center