curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties/claims' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"contact_email": "customer@example.com",
"contact_phone": "+1-555-123-4567",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "Product stopped working after 3 months of normal use. Display shows error code E01.",
"evidence": [
"https://storage.example.com/claims/photo1.jpg",
"https://storage.example.com/claims/receipt.pdf"
],
"warranty_id": "aa0e8400-e29b-41d4-a716-446655440000"
}'
{
"data": null,
"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 claim
Warranty claim created
POST
/
api
/
v1
/
warranties
/
claims
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties/claims' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"contact_email": "customer@example.com",
"contact_phone": "+1-555-123-4567",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "Product stopped working after 3 months of normal use. Display shows error code E01.",
"evidence": [
"https://storage.example.com/claims/photo1.jpg",
"https://storage.example.com/claims/receipt.pdf"
],
"warranty_id": "aa0e8400-e29b-41d4-a716-446655440000"
}'
{
"data": null,
"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
CreateWarrantyClaimRequest
string,null
Contact email for claim updates
string,null
Contact phone for claim updates
string (uuid)
required
Customer UUID filing the claim
string
required
Description of the issue
string[]
URLs to supporting evidence (photos, receipts, etc.)
string (uuid)
required
Warranty UUID to claim
Response
ApiResponse_Value
any
array,null
string,null
boolean
required
Status codes
| Code | Meaning |
|---|---|
201 | Warranty claim created |
400 | Invalid request |
404 | Warranty not found |
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/warranties/claims' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"contact_email": "customer@example.com",
"contact_phone": "+1-555-123-4567",
"customer_id": "123e4567-e89b-12d3-a456-426614174000",
"description": "Product stopped working after 3 months of normal use. Display shows error code E01.",
"evidence": [
"https://storage.example.com/claims/photo1.jpg",
"https://storage.example.com/claims/receipt.pdf"
],
"warranty_id": "aa0e8400-e29b-41d4-a716-446655440000"
}'
{
"data": null,
"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