Skip to main content
POST
https://api.stateset.com
/
v1
/
warranties
/
:id
/
replace
curl --location --request POST 'https://api.stateset.com/v1/warranties/:id/replace' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
    "replacement_product_id": "prod_xyz789",
    "replacement_reason": "Manufacturing defect",
    "shipping_address": {
        "line1": "123 Main St",
        "city": "New York",
        "state": "NY",
        "postal_code": "10001",
        "country": "US"
    },
    "expedited_shipping": true
}'
{
  "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "warranty",
  "replaced": true,
  "replacement_order_id": "ord_repl_123abc",
  "replacement_product_id": "prod_xyz789",
  "replacement_status": "shipped",
  "tracking_number": "1Z999AA10123456784",
  "estimated_delivery": "2024-01-18",
  "replacement_reason": "Manufacturing defect"
}

Body

warranty_id
string
The ID provided in the data tab may be used to identify the warranty
replacement_product_id
string
The product ID of the replacement item
replacement_reason
string
The reason for the replacement
shipping_address
object
The shipping address for the replacement item
expedited_shipping
boolean
Whether to use expedited shipping for the replacement

Response

id
string
The ID provided in the data tab may be used to identify the warranty
object
string
The object type
replacement_order_id
string
The order ID for the replacement item
replacement_product_id
string
The product ID of the replacement item
replacement_status
string
The status of the replacement (e.g., “pending”, “shipped”, “delivered”)
tracking_number
string
The tracking number for the replacement shipment
estimated_delivery
string
The estimated delivery date for the replacement
success
number
Indicates whether the call was successful. true if successful, false if not.
curl --location --request POST 'https://api.stateset.com/v1/warranties/:id/replace' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
    "replacement_product_id": "prod_xyz789",
    "replacement_reason": "Manufacturing defect",
    "shipping_address": {
        "line1": "123 Main St",
        "city": "New York",
        "state": "NY",
        "postal_code": "10001",
        "country": "US"
    },
    "expedited_shipping": true
}'
{
  "id": "e0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "warranty",
  "replaced": true,
  "replacement_order_id": "ord_repl_123abc",
  "replacement_product_id": "prod_xyz789",
  "replacement_status": "shipped",
  "tracking_number": "1Z999AA10123456784",
  "estimated_delivery": "2024-01-18",
  "replacement_reason": "Manufacturing defect"
}