---
updatedAt: 2026-07-22T21:35:35.000Z
agentTools:
  projectIndex: https://docs.getspot.com/llms.txt
---

# Submit Trip Enrollment

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/v2/enrollments/trip": {
      "post": {
        "operationId": "submitTripEnrollmentV2 v2",
        "summary": "Submit Trip Enrollment",
        "parameters": [
          {
            "name": "X-Spot-Partner-Id",
            "in": "header",
            "description": "Spot Provided ID for Partner",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "required": true,
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TripEnrollmentV2Dto"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "The enrollment has been submitted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EnrollmentResultDto"
                }
              }
            }
          },
          "400": {
            "description": "The enrollment is malformed."
          },
          "401": {
            "description": "You do not have access to submit enrollments."
          },
          "429": {
            "description": "A rate limit is in effect. Inspect the Retry-After header."
          }
        },
        "tags": [
          "Legacy Endpoints"
        ],
        "security": [
          {
            "oauth2": []
          },
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "Spot Enrollments API",
    "description": "Spot Platform API",
    "version": "3.x",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.sandbox.getspot.com",
      "description": "Sandbox Enrollments API"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "EnrollmentResultDto": {
        "type": "object",
        "properties": {
          "enrollmentId": {
            "type": "string",
            "description": "The unique id for this successful enrollment request.",
            "example": "ac572a61-dafe-4054-bb06-8f4e6b877e7e"
          },
          "enrollmentStatus": {
            "description": "The status of this enrollment. Initially New until\nwe start processing the request.",
            "example": "New",
            "enum": [
              "New",
              "Enrolling",
              "Enrolled",
              "Failed",
              "Cancelled",
              "Expired",
              "ClaimReceived",
              "UpdateFailed"
            ],
            "type": "string"
          },
          "enrollmentPath": {
            "type": "string",
            "description": "A link to fetch the enrollment status later.",
            "example": "https://api.getspot.com/api/v1/enrollments/ac572a61-dafe-4054-bb06-8f4e6b877e7e"
          }
        },
        "required": [
          "enrollmentId",
          "enrollmentStatus"
        ]
      },
      "TripPurchaserEnrollmentV2Dto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "description": "The first name of the purchaser.",
            "example": "Jane"
          },
          "lastName": {
            "type": "string",
            "description": "The last name of the purchaser.",
            "example": "Doe"
          },
          "dateOfBirth": {
            "type": "string",
            "description": "The date of birth of the purchaser. This is used\nwhen the purchaser files a claim on their behalf.\n\nIn the format: YYYY-MM-DD",
            "example": "2305-07-13"
          },
          "email": {
            "type": "string",
            "description": "The email for the purchaser. This will be used to\ncreate a Spot Account so that they may view their\ncoverage and file claims.",
            "example": "jane.doe@example.com"
          }
        },
        "required": [
          "firstName",
          "lastName",
          "email"
        ]
      },
      "TripInsuredEnrollmentV2Dto": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "description": "The first name of the insured.",
            "example": "John"
          },
          "lastName": {
            "type": "string",
            "description": "The last name of the insured.",
            "example": "Doe"
          },
          "email": {
            "type": "string",
            "description": "The email of the insured.",
            "example": "john.doe@example.com"
          },
          "dateOfBirth": {
            "type": "string",
            "description": "The date of birth of the insured. This is used\nwhen the purchaser files a claim on the insureds behalf.\n\nIn the format: YYYY-MM-DD",
            "example": "2305-07-13"
          }
        },
        "required": [
          "firstName",
          "lastName"
        ]
      },
      "TripPartnerEnrollmentV2Dto": {
        "type": "object",
        "properties": {
          "transactionId": {
            "type": "string",
            "description": "A unique id for this transaction in the partner's\nsystem. This should map to the transaction in your\nsystem where this coverage was purchased.\n\nThis is not strictly necessary, but helps Spot\ndetermine whether we have coverage enrolled\nalready.",
            "example": "UNIQ-123-ABC"
          },
          "productSku": {
            "type": "string",
            "description": "The SKU in the partner's system for the product purchased\nalongside Spot Coverage.",
            "example": "SKU-1234"
          },
          "productName": {
            "type": "string",
            "description": "The name of the product purchased alongside Spot Coverage.",
            "example": "Ikon Season Pass 23/24"
          },
          "productPrice": {
            "type": "number",
            "description": "The total price of the product purchased alongside\nSpot Coverage",
            "example": 1199.99
          }
        },
        "required": [
          "productName",
          "productPrice"
        ]
      },
      "TripPolicyAddressEnrollmentV2Dto": {
        "type": "object",
        "properties": {
          "line1": {
            "type": "string",
            "description": "Address line 1",
            "example": "1030 New Road Dr"
          },
          "line2": {
            "type": "string",
            "description": "Address line 2",
            "example": "Unit #5"
          },
          "city": {
            "type": "string",
            "description": "City",
            "example": "Austin"
          },
          "zipCode": {
            "type": "string",
            "description": "Zip code",
            "example": "78664"
          },
          "state": {
            "type": "string",
            "description": "State",
            "example": "TX"
          },
          "countryCode": {
            "type": "string",
            "description": "Country code",
            "example": "US"
          }
        },
        "required": [
          "line1",
          "state",
          "countryCode"
        ]
      },
      "TripEnrollmentV2Dto": {
        "type": "object",
        "properties": {
          "currencyCode": {
            "description": "The currency in which this coverage was purchased.",
            "example": "USD",
            "default": "USD",
            "enum": [
              "USD",
              "CAD",
              "AUD",
              "NZD",
              "EUR",
              "MXN",
              "AED",
              "GBP",
              "MAD",
              "SAR",
              "BGN",
              "BRL",
              "CHF",
              "DKK",
              "INR",
              "JPY",
              "MYR",
              "NOK",
              "PLN",
              "SEK",
              "SGD",
              "THB",
              "ZAR"
            ],
            "type": "string"
          },
          "purchaser": {
            "description": "The individual who purchased this Trip coverage.",
            "allOf": [
              {
                "$ref": "#/components/schemas/TripPurchaserEnrollmentV2Dto"
              }
            ]
          },
          "insureds": {
            "description": "A list of insured individuals who this coverage\napplies to. This may or may not include the purchaser.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TripInsuredEnrollmentV2Dto"
            }
          },
          "partner": {
            "description": "Partner provided information about the transaction.\n\nSome of this data is optional, but is useful in helping Spot\nclearly communicate to purchasers and insureds what product\nwhat sold that they purchased Spot Coverage on.",
            "allOf": [
              {
                "$ref": "#/components/schemas/TripPartnerEnrollmentV2Dto"
              }
            ]
          },
          "policyAddress": {
            "description": "The address that best aligns to the residence address\nof the insured individual on the policy. This address\nwill be used in determining any state or country based\nvariations of policy and pricing for the coverage.",
            "allOf": [
              {
                "$ref": "#/components/schemas/TripPolicyAddressEnrollmentV2Dto"
              }
            ]
          },
          "spotCost": {
            "type": "number",
            "description": "The cost of Spot Insurance coverage to the end consumer.",
            "example": 10
          },
          "startDate": {
            "format": "date-time",
            "type": "string",
            "description": "The start date for the coverage.\n\nMust be before the provided end date."
          },
          "endDate": {
            "format": "date-time",
            "type": "string",
            "description": "The end date for the coverage.\nMust be after the provided start date."
          },
          "timestamp": {
            "format": "date-time",
            "type": "string",
            "description": "The ISO8601 compliant timestamp for\nwhen this coverage was purchased."
          },
          "offerSku": {
            "type": "string",
            "description": "The Spot Offer Sku this coverage is for.",
            "example": "SKU-TI-1234"
          },
          "metadata": {
            "type": "object",
            "description": "Any additional metadata desired to be persisted. For example,\nthis might contain useful metadata to help tie the enrollment\nback to a user within the partner's system. Nested objects are\nnot supported. Keys should be defined as strings and values\nmay be of type string, number, or boolean.\n\nNOTE: Prior to using this, please consult with Spot to discuss\nyour requirements. This field is meant more as an FYI, and not\nintended to support additional, specific functionality."
          }
        },
        "required": [
          "currencyCode",
          "purchaser",
          "insureds",
          "partner",
          "policyAddress",
          "spotCost",
          "startDate",
          "endDate",
          "timestamp",
          "offerSku"
        ]
      }
    }
  }
}
```