Auto VaaS API Documentation
V2.2
1.byPolicyID
The default method of searching for a policy. It only requires the user to enter the policy number. Responses are formatted into a summary for the user to review.
1.1.Service Details
Description
The getPolicyByID method retrieves details about a policy.
Input
policyID, snapshotDate, returnBillingDetails (optional)
Output
1.2.Input: byPolicyID
Name
Data Type
Required
Default Value
Description
policyID
String
Yes
None
The formatted policy number.
snapshotDate
Calender
Yes
Current Date
The date that is spanned by a policy term (yyyy-MM-dd).
returnBillingDetails
boolean
No
true
Return billing information.
1.3.Output
Results are returned in JSON format. Although the data fields below are a sampling of what can be returned, the more data that is returned from the API the greater the impact on the financial community and deflection of human FIIs (Financial Institution Inquiries).
1.3.1.Output : PolicyDetails
Name
Data Type
Description
policyNumber
String
The formatted policy number.
effectiveDate
String
The start date of the policy term.
endorsementEffectiveDate
String
The effective date of the policy snapshot.
expirationDate
String
The end date of the policy term.
lineOfBusiness
String
The policy line of business.
snapshotDate
String
The primary insured entity.
status
String
The policy status, whether the policy is Active or Cancelled.
renewalStatus
String
The renewal status of the policy. Possible values:
Do Not Renew, Policy Cancelled, Pre Review, Renewal Bound, Review, Review
Complete
Do Not Renew, Policy Cancelled, Pre Review, Renewal Bound, Review, Review
Complete
yearsInForce
String
The number of years the policy has been in force.
1.3.2.Output: AgentDetails
Name
Data Type
Description
agencyEmail
String
The email address of the corresponding agency
agencyID
String
The internal unique identifier of the corresponding agency.
agencyLocationAddress
Address
The location address of the corresponding agency.
agencyMailingAddress
Address
The mailing address of the corresponding agency.
agencyName
String
The name of the corresponding agency.
agencyPhoneNumbers
PhoneNumber array
The set of all phone numbers of the corresponding agency.
agentEmail
String
The name of the corresponding Agent.
agentFirstName
String
The first name of the agent.
agentLastName
String
The last name of the agent.
agentPhoneNumbers
PhoneNumber array
The set of all phone numbers corresponding to the agent.
1.3.3.Output: BillingDetails
Name
Data Type
Description
paymentPlan
String
Possible values:
Full Payment
2 Pay Recurring
4 Pay Recurring
Monthly Payment Recurring
Full Payment
2 Pay Recurring
4 Pay Recurring
Monthly Payment Recurring
billTo
String
Indicates whether the policy is billed to mortagee or insured.
Possible values:
Insured
Mortgagee
Possible values:
Insured
Mortgagee
billingAddress
Address
totalPremium
String
The total premium due on the policy.
balance
String
The total balance of the policy.
1.3.4.Output: Insured
Name
Data Type
Description
company
String
The company name, if the insured is an organization.
email
String
The email address of the insured.
firstName
String
The first name of the insured, if the insured is an individual.
gender
String
The gender of the insured.
lastName
String
The last name of the insured, if the insured is an individual.
mailingAddress
Address
The mailing address of the insured.
phoneNumbers
PhoneNumber array
The set of associated phone numbers.
preferredContactMethod
String
Not currently implemented.
relationToPrimaryNamedInsured
String
If the insured is the primary, the value will be: Self.
1.3.5.Output: Address
Name
Data Type
Description
street
String
street address line 1
street2
String
street address line 2
city
String
city
stateCode
String
two digit state identifier
zip
String
5 digit zip code
latitude
String
latitudinal coordinates (optional)
longitude
String
longitudinal coordinates (optional)
1.3.6.Output: Auto
Name
Data Type
Description
year
String
Year of the vehicle.
make
String
Vehicle make.
model
String
Vehicle model.
description
String
Additional desciption of vehicle.
dateAdded
String
Date when vehicle was added to policy.
dateRemoved
String
Date when vehicle was removed from policy.
collision
String
The amount of collision deductible.
comprehensive
String
The amount of comprehensive deductible.
1.3.7.Output: Coverage
Name
Data Type
Description
name
String
The name of the coverage, e.g. Bodily Injury (Each Pers/Occurrence)
valueType
CoverageValueType
The type of the value with the following possible values
Text
Number
Boolean
Date (yyyy-MM-dd)
Text
Number
Boolean
Date (yyyy-MM-dd)
value
String
The value of the coverage, e.g. 173000.00
1.3.8.Output: InterestedParty
Name
Data Type
Description
interestedPartyId
String
firstName
String
lastName
String
company
String
email
String
phoneNumbers
PhoneNumber Array
preferredContactMethod
String
mailingAddress
String
kind
String
The type of Interested Party. Possible values:
Loss Payee
Leasing Company
Finance Company
(Custom)
Loss Payee
Leasing Company
Finance Company
(Custom)
loanNumber
String
1.4.Errors:
Error Code
Error Message
Description
E01
Specified policy number is not properly formatted
The input policyID is not properly formatted.
2.byVIN
The VIN # search method will search for a policy by it’s VIN#. It only requires the user to enter the VIN#. Responses are formatted into a search results page listing any policies where that VIN# is attached. The user can choose from the list and be directed via a subsequent API call using the known policy number to return the policy summary screen to verify the entire policy data and overages.
2.1.Service Details
Description
The “byVIN” method allows for the retrieval of policies by referencing the a known VIN# of a vehicle This returns a list of policies with that associated VIN#.
Input
Output
SearchResult array
2.2.Input: byVIN
Name
Data Type
Required
Description
vinNumber
String
Yes
Vehicle VIN #.
2.3.Output
2.3.1.Output: SearchResult
Name
Data Type
Description
effectiveDate
String
The start date of the policy term.
expirationDate
String
The end date of the policy term.
policyNumber
String
The formatted policy number.
primaryInsured
The full name of the insured, if the insured is an individual, or the company name, if the insured is an organization.
primaryAddress
The primary address associated with the policy. For Auto it will be the
mailing address of the primary insured.
mailing address of the primary insured.
status
String
The policy status.
2.3.2.Output: Insured
Name
Data Type
Description
firstName
String
The start date of the policy term.
lastName
String
The end date of the policy term.
fullName
String
The insured’s full name, i.e. first, middle, and last names plus any titles.
2.3.3.Output: Address
Name
Data Type
Description
street
String
The street address.
street2
String
The address line 2, e.g. apartment number.
city
String
stateCode
String
zip
String
fullAddress
String
The address as a single string.
3.byLastnameZip
When a policy number is not available, the search form enables two additional fields to search by a combination of a policyholder’s last name and zip code. A summary is returned of all matching last names, addresses, and zip codes. Because the policy number is also returned, when a name is selected from the list, the default API call is triggered, sending the policy number and returning policyholder data to the policy summary screen.
3.1.Service Details
Description
The “byLastnameZip” method allows for the retrieval of policies by referencing the primary insured last name in combination with the insured’s mailing zip code.
Input
Output
SearchResult array
3.2.Input: byLastnameZip
Name
Type
Required
Valid values
Description
lastName
String
Yes
The first name of the insured, if the insured is an individual.
zipCode
String
Yes
5 Digit, US Zipcode.
The zip code of the insured mailing address.
3.3.Output
3.3.1.Output: SearchResult
Name
Data Type
Description
effectiveDate
String
The start date of the policy term.
expirationDate
String
The end date of the policy term.
policyNumber
String
The formatted policy number.
primaryInsured
The full name of the insured, if the insured is an individual, or the company name, if the insured is an organization.
primaryAddress
The primary address associated with the policy. For Auto it will be the
mailing address of the primary insured.
mailing address of the primary insured.
status
String
The policy status.
3.3.2.Output: Insured
Name
Data Type
Description
firstName
String
The start date of the policy term.
lastName
String
The end date of the policy term.
fullName
String
The insured’s full name, i.e. first, middle, and last names plus any titles.
3.3.3.Output: Address
Name
Data Type
Description
street
String
The street address.
street2
String
The address line 2, e.g. apartment number.
city
String
stateCode
String
zip
String
fullAddress
String
The address as a single string.
3.4.Errors :
Error Message
Description
The policy search criteria must be specified.
The input policySearch should not be empty.
The policy search mode must be specified.
The input searchMode should not be empty.
The last name must be specified.
The input lastName should not be empty if searchMode is Name.
The business name must be specified.
The input businessName should not be empty if searchMode is BusinessName.
The phone number must be specified.
The input phoneNumber should not be empty if searchMode is PhoneNumber.
The Phone Number is invalid.
The input phoneNumber should contain one or more digits.
Please enter a value for at least one other field in addition to Last Name to narrow down the search.
The input lastName should also have at least one of firstName, insuredPropertyCity, insuredPropertyState, or
propertyZip not be empty.
propertyZip not be empty.
Your search returned too many customer records. Please enter more information and search again.
The set of matching policies is too large. Refine the input search criteria.
4.Status Codes
Status Code
0
Success
1
No policy found
2
Policy not enforce
3
Policy format invalid
-1
System failure