Policies
Submit Policy Cancellation Request
Submit a cancellation request for a policy
AuthorizationBasic <token>
Authorization header with value of Basic <auth string> where the auth string value
is a base64 encoded string of <client id>:<client secret>
In: header
Path Parameters
policy_numberstring
Response Body
application/json
application/json
application/json
curl -X POST "https://api.verticalinsure.com/v1/policies/string/cancel"{
"type": "POLICY",
"premium_amount": 50,
"premium_amount_to_show": 0,
"policy_number": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"email_address": "string",
"phone_number": "string",
"street": "string",
"city": "string",
"postal_code": "string",
"country": "st",
"state": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string",
"type": "string"
},
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"policy_status": "ACTIVE",
"issued_date": "2019-08-24T14:15:22Z",
"expiration_date": "2019-08-24T14:15:22Z",
"effective_date": "2019-08-24T14:15:22Z",
"quote_date": "2019-08-24T14:15:22Z",
"product": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"enabled": true,
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string",
"carrier_logo_url": "string",
"carrier_name": "string",
"carrier_email": "string",
"carrier_phone": "string",
"claims_url": "string"
},
"policy_attributes": {},
"gross_insurance_price": 50,
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0,
"can_cancel": true
},
"currency": "USD",
"language": "string",
"total": 0,
"taxes_and_fees": [
{
"order_item_transaction": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"policy": {
"type": "POLICY",
"premium_amount": 50,
"premium_amount_to_show": 0,
"policy_number": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"email_address": "string",
"phone_number": "string",
"street": "string",
"city": "string",
"postal_code": "string",
"country": "st",
"state": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string",
"type": "string"
},
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"policy_status": "ACTIVE",
"issued_date": "2019-08-24T14:15:22Z",
"expiration_date": "2019-08-24T14:15:22Z",
"effective_date": "2019-08-24T14:15:22Z",
"quote_date": "2019-08-24T14:15:22Z",
"product": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"enabled": true,
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string",
"carrier_logo_url": "string",
"carrier_name": "string",
"carrier_email": "string",
"carrier_phone": "string",
"claims_url": "string"
},
"policy_attributes": {},
"gross_insurance_price": 50,
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0,
"can_cancel": true
},
"currency": "USD",
"language": "string",
"total": 0,
"taxes_and_fees": [],
"version": 0,
"quote_id": "string",
"is_test": true,
"metadata": {
"property1": "string",
"property2": "string"
},
"checkout_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"cancellation_date": "2019-08-24T14:15:22Z"
},
"order": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"order_item_transactions": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"policy": {
"type": "POLICY",
"premium_amount": 50,
"premium_amount_to_show": 0,
"policy_number": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"email_address": "string",
"phone_number": "string",
"street": "string",
"city": "string",
"postal_code": "string",
"country": "st",
"state": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string",
"type": "string"
},
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"policy_status": "ACTIVE",
"issued_date": "2019-08-24T14:15:22Z",
"expiration_date": "2019-08-24T14:15:22Z",
"effective_date": "2019-08-24T14:15:22Z",
"quote_date": "2019-08-24T14:15:22Z",
"product": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"enabled": true,
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string",
"carrier_logo_url": "string",
"carrier_name": "string",
"carrier_email": "string",
"carrier_phone": "string",
"claims_url": "string"
},
"policy_attributes": {},
"gross_insurance_price": 50,
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0,
"can_cancel": true
},
"currency": "USD",
"language": "string",
"total": 0,
"taxes_and_fees": [],
"version": 0,
"quote_id": "string",
"is_test": true,
"metadata": {
"property1": "string",
"property2": "string"
},
"checkout_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"cancellation_date": "2019-08-24T14:15:22Z"
},
"order": {},
"taxes_and_fees": [
{
"order_item_transaction": {},
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"item_total": 0,
"taxes_and_fees_amount": 0,
"item_sub_total": 0,
"estimated_allocated_transaction_fee": 0,
"chargeback_fee": 0,
"ar_accounting_period": "string",
"co_accounting_period": "string",
"transaction_status": "PENDING",
"transaction_type": "REFUND",
"transaction_amount": 0,
"payment_type": "CC",
"processor": "justifi",
"estimated_processor_transaction_fee": 0,
"processor_payment_method_id": "string",
"processor_payment_id": "string",
"processor_payout_id": "string",
"processor_payout_date": "2019-08-24T14:15:22Z",
"processor_account_id": "string",
"source_total": 0,
"source_currency": "USD",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"subscription": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "string",
"payment_method": "string",
"payment_provider": "string",
"customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
"start_date": "2019-08-24",
"payments_required": 0,
"payment_amount": 0,
"orders": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"order_item_transactions": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"policy": {
"type": "POLICY",
"premium_amount": 50,
"premium_amount_to_show": 0,
"policy_number": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"email_address": "string",
"phone_number": "string",
"street": "string",
"city": "string",
"postal_code": "string",
"country": "st",
"state": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string",
"type": "string"
},
"customer": {
"email_address": "user@example.com",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"policy_status": "ACTIVE",
"issued_date": "2019-08-24T14:15:22Z",
"expiration_date": "2019-08-24T14:15:22Z",
"effective_date": "2019-08-24T14:15:22Z",
"quote_date": "2019-08-24T14:15:22Z",
"product": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"enabled": true,
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string",
"carrier_logo_url": "string",
"carrier_name": "string",
"carrier_email": "string",
"carrier_phone": "string",
"claims_url": "string"
},
"policy_attributes": {},
"gross_insurance_price": 50,
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0,
"can_cancel": true
},
"currency": "USD",
"language": "string",
"total": 0,
"taxes_and_fees": [],
"version": 0,
"quote_id": "string",
"is_test": true,
"metadata": {
"property1": "string",
"property2": "string"
},
"checkout_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"cancellation_date": "2019-08-24T14:15:22Z"
},
"order": {},
"taxes_and_fees": [
{
"order_item_transaction": {},
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"item_total": 0,
"taxes_and_fees_amount": 0,
"item_sub_total": 0,
"estimated_allocated_transaction_fee": 0,
"chargeback_fee": 0,
"ar_accounting_period": "string",
"co_accounting_period": "string",
"transaction_status": "PENDING",
"transaction_type": "REFUND",
"transaction_amount": 0,
"payment_type": "CC",
"processor": "justifi",
"estimated_processor_transaction_fee": 0,
"processor_payment_method_id": "string",
"processor_payment_id": "string",
"processor_payout_id": "string",
"processor_payout_date": "2019-08-24T14:15:22Z",
"processor_account_id": "string",
"source_total": 0,
"source_currency": "USD",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"subscription": {},
"is_initial_subscription": true,
"total": 0,
"sub_total": 0,
"taxes_and_fees_total": 0,
"currency": "USD",
"status": "REQUIRES_PAYMENT",
"placed_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z",
"failed_payment_notification_count": 0,
"failed_payment_notification_last_sent": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"is_test": true
}
],
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"is_initial_subscription": true,
"total": 0,
"sub_total": 0,
"taxes_and_fees_total": 0,
"currency": "USD",
"status": "REQUIRES_PAYMENT",
"placed_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z",
"failed_payment_notification_count": 0,
"failed_payment_notification_last_sent": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"is_test": true
},
"taxes_and_fees": [
{
"order_item_transaction": {},
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"item_total": 0,
"taxes_and_fees_amount": 0,
"item_sub_total": 0,
"estimated_allocated_transaction_fee": 0,
"chargeback_fee": 0,
"ar_accounting_period": "string",
"co_accounting_period": "string",
"transaction_status": "PENDING",
"transaction_type": "REFUND",
"transaction_amount": 0,
"payment_type": "CC",
"processor": "justifi",
"estimated_processor_transaction_fee": 0,
"processor_payment_method_id": "string",
"processor_payment_id": "string",
"processor_payout_id": "string",
"processor_payout_date": "2019-08-24T14:15:22Z",
"processor_account_id": "string",
"source_total": 0,
"source_currency": "USD",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"version": 0,
"quote_id": "string",
"is_test": true,
"metadata": {
"property1": "string",
"property2": "string"
},
"checkout_url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"cancellation_date": "2019-08-24T14:15:22Z"
}{
"error": "string",
"error_code": "string",
"message": "string",
"reason": "string",
"status": 0
}{
"links": {},
"embedded": {
"property1": [
{
"links": {
"empty": true
},
"embedded": {
"empty": true
}
}
],
"property2": [
{
"links": {
"empty": true
},
"embedded": {
"empty": true
}
}
]
},
"_links": {},
"_embedded": {
"property1": [
{
"links": {
"empty": true
},
"embedded": {
"empty": true
}
}
],
"property2": [
{
"links": {
"empty": true
},
"embedded": {
"empty": true
}
}
]
},
"message": "string",
"logref": "string",
"path": "string"
}