curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"expiration_date": "2026-12-09T00:00:00Z",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"serial_number": "SN-WBH-2024-001234",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse.",
"warranty_type": "manufacturer"
}'
{
"data": {
"created_at": "2024-12-09T10:30:00Z",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "2-year manufacturer warranty covering defects in materials and workmanship",
"end_date": "2026-12-09T00:00:00Z",
"id": "aa0e8400-e29b-41d4-a716-446655440000",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"start_date": "2024-12-09T00:00:00Z",
"status": "active",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse, accidents, or unauthorized modifications.",
"updated_at": "2024-12-09T10:30:00Z",
"warranty_number": "WRN-2024-001234"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Create a warranty
Create a warranty
POST
/
api
/
v1
/
warranties
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"expiration_date": "2026-12-09T00:00:00Z",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"serial_number": "SN-WBH-2024-001234",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse.",
"warranty_type": "manufacturer"
}'
{
"data": {
"created_at": "2024-12-09T10:30:00Z",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "2-year manufacturer warranty covering defects in materials and workmanship",
"end_date": "2026-12-09T00:00:00Z",
"id": "aa0e8400-e29b-41d4-a716-446655440000",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"start_date": "2024-12-09T00:00:00Z",
"status": "active",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse, accidents, or unauthorized modifications.",
"updated_at": "2024-12-09T10:30:00Z",
"warranty_number": "WRN-2024-001234"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Request body
CreateWarrantyRequest
string (uuid)
required
Customer UUID
string (date-time)
required
Warranty expiration date
string (uuid)
required
Product UUID to warranty
string
required
Product serial number
string
required
Warranty terms and conditions
string
required
Warranty type (manufacturer, extended, limited)
Response
ApiResponse_WarrantySummary
object
Show data
Show data
string (date-time)
required
Creation timestamp
string (uuid)
required
Customer UUID who owns the warranty
string,null
Warranty description
string (date-time)
required
Warranty expiration date
string (uuid)
required
Warranty UUID
string (uuid)
required
Product UUID covered by warranty
string (date-time)
required
Warranty start date
string
required
Warranty status (active, expired, claimed, void)
string,null
Warranty terms and conditions
string,null (date-time)
Last update timestamp
string
required
Human-readable warranty number
array,null
string,null
boolean
required
Status codes
| Code | Meaning |
|---|---|
201 | Warranty created |
400 | Invalid request |
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"expiration_date": "2026-12-09T00:00:00Z",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"serial_number": "SN-WBH-2024-001234",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse.",
"warranty_type": "manufacturer"
}'
{
"data": {
"created_at": "2024-12-09T10:30:00Z",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "2-year manufacturer warranty covering defects in materials and workmanship",
"end_date": "2026-12-09T00:00:00Z",
"id": "aa0e8400-e29b-41d4-a716-446655440000",
"product_id": "550e8400-e29b-41d4-a716-446655440000",
"start_date": "2024-12-09T00:00:00Z",
"status": "active",
"terms": "Covers manufacturing defects only. Does not cover damage from misuse, accidents, or unauthorized modifications.",
"updated_at": "2024-12-09T10:30:00Z",
"warranty_number": "WRN-2024-001234"
},
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Last modified on August 31, 2026