$ provenance-docs — api reference

verification api

Unified asset verification across Provenance planets. All endpoints require a Bearer token issued from the main app.

base url

https://api.provenance.guru

Local development: http://localhost:3100

planets

Planet	Subdomain	Description
Artworks	provenance.guru	Art provenance, certificates of authenticity, and artist verification
Collectibles	collc.provenance.guru	Collectible authentication, grading verification, and ownership tracking
Real Estate	rest.provenance.guru	Property provenance, deed history, and title verification
Vehicles	auto.provenance.guru	Vehicle history, VIN verification, and ownership chain tracking

endpoints

POST/api/v1/verifyVerify an asset GET/api/v1/assets/{planet}/{id}Get asset details GET/api/v1/assets/{planet}/{id}/historyAsset event history POST/api/v1/assets/{planet}Create an asset GET/api/v1/certificates/{number}Look up certificate POST/api/v1/webhooksRegister webhook

guides

overviewVerification API introduction and base URL.authenticationBearer tokens, key scopes, and rate limits.planetsVerticals: artworks, collectibles, real estate, vehicles.verify assetPOST /api/v1/verify — run verification on an asset.get assetGET /api/v1/assets/{planet}/{id}asset historyGET /api/v1/assets/{planet}/{id}/history create assetPOST /api/v1/assets/{planet}certificatesGET /api/v1/certificates/{number}webhooksPOST /api/v1/webhooks — register event notifications.errorsHTTP status codes and error response format.