Vertical Insure
Purchase & Bind Policies

Purchase V2

Purchases one or more quotes.All quotes must be in QUOTED state.

POST
/v2/purchase

Authorization

basic auth
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

Request Body

application/json

quotes*
Items1 <= items
payment_method*

Only one of a card, bank_account or token payment is required.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.verticalinsure.com/v2/purchase" \  -H "Content-Type: application/json" \  -d '{    "quotes": [      {        "customer": {          "email_address": "user@example.com",          "first_name": "string",          "last_name": "string"        },        "quote_id": "string"      }    ],    "payment_method": {}  }'
[
  {
    "status": "success",
    "data": {
      "policy_holder": {
        "first_name": "string",
        "middle_name": "string",
        "last_name": "string",
        "email_address": "string",
        "email_address_hash": "string",
        "phone_number": "string",
        "street": "string",
        "city": "string",
        "state": "string",
        "postal_code": "string",
        "country": "string"
      },
      "policy_attributes": {},
      "premium_amount": 50,
      "policy_number": "string",
      "partner": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "legal_business_name": "string"
      },
      "policy_documents": [
        {
          "document_type": "POLICY",
          "url": "string"
        }
      ],
      "policy_status": "ACTIVE",
      "issued_date": "2019-08-24T14:15:22Z",
      "expiration_date": "string",
      "effective_date": "string",
      "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",
        "layout": "string",
        "carrier_logo_url": "string",
        "carrier_name": "string",
        "carrier_email": "string",
        "carrier_phone": "string",
        "claims_url": "string"
      },
      "endorsement_price_changes": 0,
      "subscription_premium": {
        "payments_required": 0,
        "payment_amount": 0,
        "can_cancel": true
      },
      "currency": "USD",
      "language": "string",
      "total": 0,
      "taxes_and_fees": [
        {
          "amount": 0,
          "description": "string",
          "type": "fee",
          "included_in_premium": true,
          "include_in_marketing_share": true,
          "refundable": true,
          "taxable": true,
          "per_subscription_charge": true,
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z"
        }
      ],
      "version": 0,
      "quote_id": "string",
      "offer_id": "d5a7a5b7-a4a3-49e7-9c69-b44d2cbe15cf",
      "distribution_channel": "string",
      "is_test": true,
      "metadata": {
        "property1": "string",
        "property2": "string"
      },
      "checkout_url": "string",
      "recommendation": {
        "message": "string",
        "enabled": true
      }
    }
  }
]
{
  "error": "string",
  "error_code": "string",
  "message": "string",
  "reason": "string",
  "status": 0
}
{
  "error": "string",
  "error_code": "string",
  "message": "string",
  "reason": "string",
  "status": 0
}