Chargement...
Integrate Verisav into your systems and automate your after-sales service management processes
The Verisav API allows you to integrate all platform features into your existing systems. Whether you want to automate warranty management, synchronize product data, or create custom workflows, our REST API provides all the tools you need.
Our API follows industry standards with a RESTful architecture, JSON responses, and secure authentication. It's designed to be simple to use, well-documented, and performant.
Automate your processes, synchronize your data in real-time, and create personalized experiences for your customers. The Verisav API integrates seamlessly with your existing systems.
All requests to the Verisav API require authentication via an API token. You can obtain your credentials from your Verisav dashboard.
Log in to the professional space, then go to Settings > API Keys to generate or regenerate your token. The token remains valid until manually revoked.
Authorization: Bearer YOUR_API_TOKENNever share your API tokens publicly. Keep them secure and regenerate them regularly. Tokens must be transmitted in the Authorization header of each request.
Follow these simple steps to start using the Verisav API:
Log in to your Verisav dashboard and generate your API keys from the Settings section.
Add your API token in the Authorization header of your HTTP requests: Authorization: Bearer YOUR_API_TOKEN
Test your configuration by fetching a product DPP. Replace ABC123 with a real shortId:
Example:
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Discover all available endpoints to integrate Verisav into your systems. Each endpoint is documented with request and response examples.
The cards below show API families: RDF vocabularies (DPP, RMA, WTY), GraphQL, and REST. The API v1 Reference section details the complete REST v1 API with exact paths.
Digital Product Passport (DPP) management
/api/dppReturns and exchanges (RMA) management
/api/rmaWarranty (WTY) management
/api/wtyAccess to vocabularies and taxonomies
/api/v1/vocabularyGraphQL API for flexible queries
/api/graphqlComplete documentation for each Verisav API v1 endpoint. Base URL: https://www.verisav.fr. Each API is documented with its path, method, description, and parameters. All requests require the Authorization: Bearer YOUR_API_TOKEN header.
Required headers: Authorization: Bearer {token}, Content-Type: application/json for POST/PATCH.
/api/v1/dpp/{shortId}Retrieves the DPP by short identifier (shortId).
Parameters: shortId — Product short identifier
/api/v1/dpp?gtin=&serial=Retrieves the DPP by GTIN + serial number.
Parameters: gtin, serial — GTIN and serial number
/api/v1/products/{id}/warrantyProduct warranty information.
Parameters: id — Product UUID
/api/v1/products/{id}/activateActivates the product (purchase registration).
Parameters: id — Product UUID
/api/v1/products/{id}/usageRetrieves product usage data.
Parameters: id — Product UUID
/api/v1/products/{id}/usageRecords or updates usage data.
Parameters: id — Product UUID
/api/v1/products/{id}/supply-chainSupply chain and traceability.
Parameters: id — Product UUID
/api/v1/products/bulkBulk queries for multiple products.
Parameters: id — Product UUID
/api/v1/products/{id}/douaneUpdates customs information (UN-CPC, TARIC, etc.).
Parameters: Body: product_category_code, product_category_scheme (UN-CPC, TARIC)
/api/v1/products/{id}/materialsRetrieves product material composition.
Parameters: id — Product UUID
/api/v1/products/{id}/materialsRecords or updates material composition.
Parameters: id — Product UUID
/api/v1/products/{id}/conformityRetrieves conformity declarations.
Parameters: id — Product UUID
/api/v1/products/{id}/conformityRecords or updates conformity declarations.
Parameters: id — Product UUID
/api/v1/products/{id}/traceabilityRetrieves traceability data.
Parameters: id — Product UUID
/api/v1/products/{id}/traceabilityRecords or updates traceability data.
Parameters: id — Product UUID
/api/v1/products/{id}/verifiable-credentialsReturns product Verifiable Credentials (JSON-LD).
Parameters: id — Product UUID
/api/v1/products/{id}/verifiable-credentials?format=jwtReturns signed Verifiable Credentials in JWT format.
Parameters: id — Product UUID
/api/v1/products/{id}/transfer-ownershipTransfers product ownership to another actor.
Parameters: id — Product UUID
/api/v1/products/{id}/auraExport in Aura Consortium format.
Parameters: id — Product UUID
/api/v1/claimsCreates a new after-sales claim.
/api/v1/claims/{id}/statusClaim status by identifier.
Parameters: id — Claim UUID
/api/v1/claims/bulkBulk queries for multiple claims.
/api/v1/repairers/nearby?lat=&lng=&radius=&limit=List of nearby repairers (lat, lng, radius, limit).
Parameters: lat, lng — Coordinates; radius — Radius (km); limit — Max count
/api/v1/repairers/{id}/availabilityRepairer availability.
Parameters: id — Repairer UUID
/api/v1/suppliers/dataSupplier data submission to Verisav.
/api/v1/webhooksRegister a webhook to receive events.
Parameters: url — Callback URL; events — Event list
Response codes: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Server Error
DPP — Example request
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Produits — Activer
curl -X POST "https://www.verisav.fr/api/v1/products/{id}/activate" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'Réparateurs — À proximité
curl -X GET "https://www.verisav.fr/api/v1/repairers/nearby?lat=44.84&lng=-0.58&radius=50&limit=10" \
-H "Authorization: Bearer YOUR_API_TOKEN"Register a webhook via POST /api/v1/webhooks to receive real-time notifications (claim creation, ownership transfer, etc.). Perfect for synchronizing your systems and automating your workflows.
Supported events: claim.created, ownership.transferred, product.activated, etc.
Registration example:
curl -X POST "https://www.verisav.fr/api/v1/webhooks" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-domain.com/webhook",
"events": ["claim.created", "ownership.transferred", "product.activated"]
}'Errors are returned in JSON: {"error": "message", "code": "ERROR_CODE"}. The request body is parsed to provide details on invalid fields.
The API applies rate limits per token. If exceeded, a 429 Too Many Requests response is returned with the Retry-After header. Contact us for high-volume needs.
Our team is here to help you integrate the Verisav API into your systems. Check out our complete documentation or contact our support.