API Overview Resources Schemas

Subscription Operations

Terminate subscription

POST /{service_type}/{service_id}/terminate

Parameters

Name	In	Type	Required	Description
Request-Correlation-Id	header	string(uuid)	false	Correlation Id for tracing (unique identifier)
service_type	path	string	true	Service type indicator (must be deviceinsurance)
service_id	path	string	true	Service identifier (policy number or subscription ID)
body	body	terminateMovementRequestDTO	true	Contains termination information

Enumerated Values

Property	Values
service_type	one of [deviceinsurance]

Request body - instance of terminateMovementRequestDTO

1
2
3
4


{
  "reason": "SUBSCRIBER_RESIGNATION",
  "deactivation_date": "2025-12-03T10:30:00Z"
}

Name	Type	Required	Description
reason	string	true	Reason for terminating the device insurance
deactivation_date	string(date-time)	true	Deactivation date for the device insurance (ISO 8601 format)

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10



curl -X POST https://partners.sta.masstack.com/v3/deviceinsurance/3500038700026229/terminate \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Request-Correlation-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \
 --data-raw "{
  'reason': 'SUBSCRIBER_RESIGNATION',
  'deactivation_date': '2025-12-03T10:30:00Z'
}" 

Responses

Code	Meaning	Description	Schema
200	OK	Successfully terminated the device insurance	terminateSuccessResponseDTO
400	Bad Request	Bad Request	genericErrorResponseDTO
404	Not Found	Not found	genericErrorResponseDTO
500	Internal Server Error	Internal Server Error	genericErrorResponseDTO

Endpoints

Barrings Operations

Billing Operations

Subscription Operations

Promotions Operations

Service Operations