Watch Certificate™ API
Create your watches' passports from your tools
The Watch Certificate™ API connects your ERP, your point-of-sale software or your website to each watch's digital passport: you create the watch, link its card, declare the buyer and follow its history. Without typing anything again in the app.
curl -X POST https://api.watchcertificate.org/api/v1/watches/create \
-H "api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "externalRef": "SKU-0001", "watchBrand": "Example", "watchModel": "Classic", "watchReference": "1234" }'In short
REST and JSON, over HTTPS, at
api.watchcertificate.org.An API key in the
api-keyheader, created in the app (Settings, Configuration, API access).A test environment, separate from production, with test cards.
Seven languages for the labels returned: French, English, German, Spanish, Italian, Japanese, Chinese.
A watch's journey
Create the watch:
POST /watches/create, with your own reference (externalRef).Send the photos:
POST /files/upload, one photo or one PDF per call.Link the card:
POST /certificates/can-link-cardto check, thenPOST /certificates/link-card. The watch becomes a passport.Declare the buyer:
POST /certificates/declare-owner/{certificateCardId}. They receive their passport by email, and the warranty starts.Follow the watch: services, repairs and warranty, for its whole life.
What else you can do
- Find a watch or a passport by your reference.
- Manage your retailers and service centers, and place your watches in their stock.
- Order a certification from an approved workshop.
The questions we are asked
- 1Connect your ERPWatches, network stock, sales: what your ERP sends, and when.
- 2Connect your CRMFind your customers, and what they agreed to share.
- 3The documentation and the test accessA complete reference of the API, and a test account ready to use, to try it without risk.
- 4Who calls whomYour system calls Watch Certificate™. We write to the owner.
- 5The required fields and the photos' formatCreating a watch requires no field. A passport does: what is required depends on its level of attestation.
- 6What the API returnsJSON, always the complete resource, and a stable error code when something blocks.
- 7The change of owner and the after-sales serviceAt the sale, you declare the buyer and the warranty starts. Then the passport follows the watch: services, repairs, resales.
- 8A retailer's stockThe watches of your stock, those a manufacture entrusted to you included: list them, find one, and transfer a watch not sold yet to another retailer of its manufacture.