Astoria Company Auto Insurance (Shared / Bid On Legs) Integration Instructions


Contents

IMPORTANT NOTE: PLEASE ENSURE YOU CAREFULLY FOLLOW THE TESTING INSTRUCTIONS ONCE YOU'VE COMPLETED THE INTEGRATION!




Introduction to Ping/Post

Auto Insurance (Shared / Bid On Legs) is a two-step integration process. Commonly, it is referred to as ping/post, i.e. first you send us a 'ping' (all data EXCEPT PII) and we respond with a bid (or outright rejection). Assuming we are the winning bidder, you would then 'post' the lead data (this time including PII), along with the <confirmation> code you received in the ping response.

Please review the following to complete the integration. When you believe you are ready, please follow these steps to test your integration, and then email us at tech@astoriacompany.com

Back to contents




Introduction to Bid on Legs (BoL)

Bid on Legs (BoL) is a variation of ping/post. By adding a simple parameter to your 'ping' request, our system responses will be altered to bid on specific 'legs' of a lead for a given carrier on agent. Assuming we are the winning bidder, you would then 'post' the lead data (this time including PII), along with the <confirmation> code you received in the ping response AND the information about which 'legs' we won.

Back to contents




Help / Support

For help or support, or if you have any questions during the integration, please email us at tech@astoriacompany.com

Back to contents




Ping:

What is a Ping?

A Ping is a call to our API with all of the lead data EXCEPT the PII. It's purpose is to determine if there is any interest in purchasing the lead, and if there is, to establish the price we would be willing to pay if a subsequent Post for the same lead is accepted.

IMPORTANT NOTE: TO ENSURE YOUR ACCOUNT IS NOT TEMPORARILY SUSPENDED BY OUR AUTO-THROTTLING MECHANISM, PLEASE DO NOT EXCEED 300 PINGS IN ANY 5 MINUTE PERIOD.

Field names and acceptable values

The absence of any required field (Required) will result in an error. If you do not collect the data for a required field, please refer to the 'Suggested Default' column.
Preferred fields (Preferred) may be omitted, but doing so could reduce a lead's chances of finding a buyer.
Optional fields (Optional) can be omitted without any major impact.

Field Contents Suggested Default Required?
bid_on_leg Determines that this is a Bid on Legs (BoL) lead.
MUST be '1' to receive a BoL formatted response.
1 Required
lead_type Determines the type of lead.
MUST be '5' for Auto Insurance (Shared / Bid On Legs)
5 Required
lead_mode Determines if the lead should be treated as a test lead or a live lead.
0 = TEST LEAD
1 = LIVE LEAD
Click here for full testing instructions.
Required
vendor_id This is the VID code you were provided by Astoria; if you do not know it, please contact us.
Please ensure you are using the correct code, otherwise your leads may be credited to another partner!
Required
sub_id Code of your choosing for your own tracking purposes, e.g. '123-ABC'
This should enable us to distinguish your lead sources from each other, so that we can optimize lead flow to buyers.
There is a maximum length of 35 characters, and it may only contain letters, numbers, underscores and hyphens.
Required
tcpa_optin Indicates whether or not the consumer was presented with, and accepted, unambiguous consent to be contacted via automated telephone systems pursuant to TCPA requirements.
0 = No
1 = Yes
Click here for more information.
0 Required
tcpa_text Contains the TCPA language the consumer was presented with on the form where their information was submitted,
e.g. 'By submitting this form…'
Click here for more information.
Required
universal_leadid Unique LeadiD as generated by LeadiD.com,
e.g. '43C9E7AC-0C6A-18E5-4C78-4949E6D561AB'
Required
origination_datetime Date/time when lead was submitted by consumer, in format 'YYYY-MM-DD hh:mm:ss',
e.g. '2019-05-19 13:21:05'
Required
origination_timezone The timezone for the date/time passed in origination_datetime.
1 = EST / EDT
2 = CST / CDT
3 = MST / MDT
4 = PST / PDT
Required
ipaddress Applicants IP address, e.g. '18.234.88.196' Required
user_agent The user agent string for the browser used by the applicant when their information was submitted,
e.g. 'CCBot/2.0 (https://commoncrawl.org/faq/)'
Preferred
vendor_lead_id Your internal ID for this lead (useful if we need to contact you about a specific lead and when processing returns),
e.g. '72684225'
Preferred
url URL of form where lead was generated, e.g. 'http://ratechecker.com/auto-insurance/' Preferred
minimum_price Minimum price you would accept for this lead, no $ symbol or commas, e.g. '2.00'
NOTE: For test leads (i.e. where lead_mode=0), our 'buyers' return very low prices (for safety). If you choose to include this optional parameter, then please set it to just '0.01' when testing to ensure you receive the expected responses.
WARNING: Setting a minimum_price will cause you to sell fewer leads!
Optional
zip Valid 5-digit US Zip Code.
Can be used when lead_mode=0 to influence test results.
Click here for full testing instructions.
Required
phone_last_4 Last 4 digits of primary_phone.
REQUESTED ON PING ONLY! REQUIRED by one of our largest buyers.
Preferred
residence_type Primary applicants residence status.
0 = Own
1 = Rent
1 Required
years_at_residence Primary applicants years at residence.
0 = 0 Years
1 = 1 Year
2 = 2 Years
3 = 3 Years
4 = 4 Years
5 = 5 Years
6 = 6 Years
7 = 7 Years
8 = 8 Years
9 = 9 Years
10 = 10 or more Years
3 Required
months_at_residence Primary applicants months at residence.
0 = 0 Months
1 = 1 Month
2 = 2 Months
3 = 3 Months
4 = 4 Months
5 = 5 Months
6 = 6 Months
7 = 7 Months
8 = 8 Months
9 = 9 Months
10 = 10 Months
11 = 11 Months
0 Required
credit_rating Primary applicants credit rating.
1 = Excellent
2 = Good
3 = Fair
4 = Poor
2 Required
bankruptcy Has primary applicant filed for bankruptcy in the past 7 years?
0 = No
1 = Yes
0 Required
coverageType Coverage Type.
1 = Superior ($250k/$500k Injury, $100k Property)
2 = Standard ($100k/$300k Injury, $50k Property)
3 = Basic ($50k/$100k Injury, $25k Property)
4 = State Minimum
3 Required
vehicle_comprehensiveDeductible Comprehensive Deductible for policy.
1 = $0
2 = $50
3 = $100
4 = $250
5 = $500
6 = $1,000
7 = $2,500
8 = $5,000
4 Required
vehicle_collisionDeductible Collision Deductible for policy.
1 = $0
2 = $50
3 = $100
4 = $250
5 = $500
6 = $1,000
7 = $2,500
8 = $5,000
4 Required
medicalPayment Amount of Medical Coverage.
1 = $0
2 = $500
3 = $1,000
4 = $2,000
5 = $5,000
6 = $25,000
7 = $50,000
8 = $100,000
5 Required
haveInsurance Indicates whether driver1 has a current auto insurance policy or not.
Note: May include auto insurance policies that have expired no more than 30 days in the past.
0 = No
1 = Yes
0 Required

If haveInsurance = 1 (Yes) then the following fields are required.

insuranceCompany Driver1's current insurance company - see Insurance Company Values
Note that we do NOT recommend a default mapping of '1' (Company Not Listed) for this field as doing so will result in very few leads being accepted.
Required
current_policy_start_date Driver1's current policy start date, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required
current_policy_expiration_date Driver1's current policy expiration date, in the format YYYY-MM-DD, e.g. '2019-06-02'
Note: Could be a date no more than 30 days in the past, the current date, or a future date.
Required
continuously_insured_period Driver1's period of continuous auto insurance coverage.
1 = Less than 6 Months
2 = 6 Months to 1 Year
3 = 1 Year
4 = 2 Years
5 = 3 Years
6 = 4 Years
7 = 5 Years
8 = 6+ Years
1 Required

Driver 1 Information - This section is Required

driver1_gender Driver1 gender.
0 = Male
1 = Female
0 Required
driver1_dob Driver1 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver1_maritalStatus Driver1 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver1_education Driver1 education level.
See Driver Education Level Values
123 Required
driver1_occupation Driver1 occupation.
See Driver Occupation Values
123 Required
driver1_requiredSR22 Driver1 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 1 Tickets, Accidents, Violations and Claims

driver1_hasTAVCs Does Driver1 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver1_hasTAVCs = 1 then the following fields are required:

driver1_numOfIncidents The number of incidents to report for driver1.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 1, Incident 1: If driver1_numOfIncidents >= 1 then the following fields are required:

driver1_incidentType1 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate1 Date of Driver1 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType1 = 1 (Ticket) then the following fields are required:

driver1_ticket1Description Driver1 Ticket1 Description
See Driver Ticket Description Values
Required

If driver1_incidentType1 = 2 (Accident) then the following fields are required:

driver1_accident1Description Driver1 Accident1 Description
See Driver Accident Description Values
Required
driver1_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident1Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType1 = 3 (Violation) then the following fields are required:

driver1_violation1Description Driver1 Violation1 Description
See Driver Violation Description Values
Required
driver1_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType1 = 4 (Claim) then the following fields are required:

driver1_claim1Description Driver1 Claim1 Description
See Driver Claim Description Values
Required
driver1_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 2: If driver1_numOfIncidents >= 2 then the following fields are required:

driver1_incidentType2 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate2 Date of Driver1 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType2 = 1 (Ticket) then the following fields are required:

driver1_ticket2Description Driver1 Ticket2 Description
See Driver Ticket Description Values
Required

If driver1_incidentType2 = 2 (Accident) then the following fields are required:

driver1_accident2Description Driver1 Accident2 Description
See Driver Accident Description Values
Required
driver1_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident2Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType2 = 3 (Violation) then the following fields are required:

driver1_violation2Description Driver1 Violation2 Description
See Driver Violation Description Values
Required
driver1_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType2 = 4 (Claim) then the following fields are required:

driver1_claim2Description Driver1 Claim2 Description
See Driver Claim Description Values
Required
driver1_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 3: If driver1_numOfIncidents >= 3 then the following fields are required:

driver1_incidentType3 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate3 Date of Driver1 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType3 = 1 (Ticket) then the following fields are required:

driver1_ticket3Description Driver1 Ticket3 Description
See Driver Ticket Description Values
Required

If driver1_incidentType3 = 2 (Accident) then the following fields are required:

driver1_accident3Description Driver1 Accident3 Description
See Driver Accident Description Values
Required
driver1_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident3Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType3 = 3 (Violation) then the following fields are required:

driver1_violation3Description Driver1 Violation3 Description
See Driver Violation Description Values
Required
driver1_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType3 = 4 (Claim) then the following fields are required:

driver1_claim3Description Driver1 Claim3 Description
See Driver Claim Description Values
Required
driver1_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 4: If driver1_numOfIncidents >= 4 then the following fields are required:

driver1_incidentType4 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate4 Date of Driver1 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType4 = 1 (Ticket) then the following fields are required:

driver1_ticket4Description Driver1 Ticket4 Description
See Driver Ticket Description Values
Required

If driver1_incidentType4 = 2 (Accident) then the following fields are required:

driver1_accident4Description Driver1 Accident4 Description
See Driver Accident Description Values
Required
driver1_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident4Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType4 = 3 (Violation) then the following fields are required:

driver1_violation4Description Driver1 Violation4 Description
See Driver Violation Description Values
Required
driver1_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType4 = 4 (Claim) then the following fields are required:

driver1_claim4Description Driver1 Claim4 Description
See Driver Claim Description Values
Required
driver1_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2 Information - This section is Preferred if driver1_maritalStatus = 2 (Married), but may be omitted if unknown

driver2_gender Driver2 gender.
0 = Male
1 = Female
0 Required
driver2_dob Driver2 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver2_relationshipToApplicant Driver2 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver2_maritalStatus Driver2 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver2_education Driver2 education level.
See Driver Education Level Values
123 Required
driver2_occupation Driver2 occupation.
See Driver Occupation Values
123 Required
driver2_requiredSR22 Driver2 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 2 Tickets, Accidents, Violations and Claims

driver2_hasTAVCs Does Driver2 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver2_hasTAVCs = 1 then the following fields are required:

driver2_numOfIncidents The number of incidents to report for driver2.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 2, Incident 1: If driver2_numOfIncidents >= 1 then the following fields are required:

driver2_incidentType1 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate1 Date of Driver2 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType1 = 1 (Ticket) then the following fields are required:

driver2_ticket1Description Driver2 Ticket1 Description
See Driver Ticket Description Values
Required

If driver2_incidentType1 = 2 (Accident) then the following fields are required:

driver2_accident1Description Driver2 Accident1 Description
See Driver Accident Description Values
Required
driver2_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident1Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType1 = 3 (Violation) then the following fields are required:

driver2_violation1Description Driver2 Violation1 Description
See Driver Violation Description Values
Required
driver2_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType1 = 4 (Claim) then the following fields are required:

driver2_claim1Description Driver2 Claim1 Description
See Driver Claim Description Values
Required
driver2_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 2: If driver2_numOfIncidents >= 2 then the following fields are required:

driver2_incidentType2 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate2 Date of Driver2 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType2 = 1 (Ticket) then the following fields are required:

driver2_ticket2Description Driver2 Ticket2 Description
See Driver Ticket Description Values
Required

If driver2_incidentType2 = 2 (Accident) then the following fields are required:

driver2_accident2Description Driver2 Accident2 Description
See Driver Accident Description Values
Required
driver2_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident2Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType2 = 3 (Violation) then the following fields are required:

driver2_violation2Description Driver2 Violation2 Description
See Driver Violation Description Values
Required
driver2_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType2 = 4 (Claim) then the following fields are required:

driver2_claim2Description Driver2 Claim2 Description
See Driver Claim Description Values
Required
driver2_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 3: If driver2_numOfIncidents >= 3 then the following fields are required:

driver2_incidentType3 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate3 Date of Driver2 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType3 = 1 (Ticket) then the following fields are required:

driver2_ticket3Description Driver2 Ticket3 Description
See Driver Ticket Description Values
Required

If driver2_incidentType3 = 2 (Accident) then the following fields are required:

driver2_accident3Description Driver2 Accident3 Description
See Driver Accident Description Values
Required
driver2_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident3Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType3 = 3 (Violation) then the following fields are required:

driver2_violation3Description Driver2 Violation3 Description
See Driver Violation Description Values
Required
driver2_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType3 = 4 (Claim) then the following fields are required:

driver2_claim3Description Driver2 Claim3 Description
See Driver Claim Description Values
Required
driver2_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 4: If driver2_numOfIncidents >= 4 then the following fields are required:

driver2_incidentType4 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate4 Date of Driver2 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType4 = 1 (Ticket) then the following fields are required:

driver2_ticket4Description Driver2 Ticket4 Description
See Driver Ticket Description Values
Required

If driver2_incidentType4 = 2 (Accident) then the following fields are required:

driver2_accident4Description Driver2 Accident4 Description
See Driver Accident Description Values
Required
driver2_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident4Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType4 = 3 (Violation) then the following fields are required:

driver2_violation4Description Driver2 Violation4 Description
See Driver Violation Description Values
Required
driver2_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType4 = 4 (Claim) then the following fields are required:

driver2_claim4Description Driver2 Claim4 Description
See Driver Claim Description Values
Required
driver2_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3 Information - This entire section may be omitted if there is no driver3

driver3_gender Driver3 gender.
0 = Male
1 = Female
0 Required
driver3_dob Driver3 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver3_relationshipToApplicant Driver3 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver3_maritalStatus Driver3 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver3_education Driver3 education level.
See Driver Education Level Values
123 Required
driver3_occupation Driver3 occupation.
See Driver Occupation Values
123 Required
driver3_requiredSR22 Driver3 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 3 Tickets, Accidents, Violations and Claims

driver3_hasTAVCs Does Driver3 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver3_hasTAVCs = 1 then the following fields are required:

driver3_numOfIncidents The number of incidents to report for driver3.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 3, Incident 1: If driver3_numOfIncidents >= 1 then the following fields are required:

driver3_incidentType1 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate1 Date of Driver3 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType1 = 1 (Ticket) then the following fields are required:

driver3_ticket1Description Driver3 Ticket1 Description
See Driver Ticket Description Values
Required

If driver3_incidentType1 = 2 (Accident) then the following fields are required:

driver3_accident1Description Driver3 Accident1 Description
See Driver Accident Description Values
Required
driver3_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident1Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType1 = 3 (Violation) then the following fields are required:

driver3_violation1Description Driver3 Violation1 Description
See Driver Violation Description Values
Required
driver3_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType1 = 4 (Claim) then the following fields are required:

driver3_claim1Description Driver3 Claim1 Description
See Driver Claim Description Values
Required
driver3_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 2: If driver3_numOfIncidents >= 2 then the following fields are required:

driver3_incidentType2 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate2 Date of Driver3 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType2 = 1 (Ticket) then the following fields are required:

driver3_ticket2Description Driver3 Ticket2 Description
See Driver Ticket Description Values
Required

If driver3_incidentType2 = 2 (Accident) then the following fields are required:

driver3_accident2Description Driver3 Accident2 Description
See Driver Accident Description Values
Required
driver3_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident2Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType2 = 3 (Violation) then the following fields are required:

driver3_violation2Description Driver3 Violation2 Description
See Driver Violation Description Values
Required
driver3_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType2 = 4 (Claim) then the following fields are required:

driver3_claim2Description Driver3 Claim2 Description
See Driver Claim Description Values
Required
driver3_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 3: If driver3_numOfIncidents >= 3 then the following fields are required:

driver3_incidentType3 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate3 Date of Driver3 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType3 = 1 (Ticket) then the following fields are required:

driver3_ticket3Description Driver3 Ticket3 Description
See Driver Ticket Description Values
Required

If driver3_incidentType3 = 2 (Accident) then the following fields are required:

driver3_accident3Description Driver3 Accident3 Description
See Driver Accident Description Values
Required
driver3_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident3Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType3 = 3 (Violation) then the following fields are required:

driver3_violation3Description Driver3 Violation3 Description
See Driver Violation Description Values
Required
driver3_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType3 = 4 (Claim) then the following fields are required:

driver3_claim3Description Driver3 Claim3 Description
See Driver Claim Description Values
Required
driver3_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 4: If driver3_numOfIncidents >= 4 then the following fields are required:

driver3_incidentType4 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate4 Date of Driver3 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType4 = 1 (Ticket) then the following fields are required:

driver3_ticket4Description Driver3 Ticket4 Description
See Driver Ticket Description Values
Required

If driver3_incidentType4 = 2 (Accident) then the following fields are required:

driver3_accident4Description Driver3 Accident4 Description
See Driver Accident Description Values
Required
driver3_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident4Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType4 = 3 (Violation) then the following fields are required:

driver3_violation4Description Driver3 Violation4 Description
See Driver Violation Description Values
Required
driver3_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType4 = 4 (Claim) then the following fields are required:

driver3_claim4Description Driver3 Claim4 Description
See Driver Claim Description Values
Required
driver3_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4 Information - This entire section may be omitted if there is no driver4

driver4_gender Driver4 gender.
0 = Male
1 = Female
0 Required
driver4_dob Driver4 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver4_relationshipToApplicant Driver4 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver4_maritalStatus Driver4 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver4_education Driver4 education level.
See Driver Education Level Values
123 Required
driver4_occupation Driver4 occupation.
See Driver Occupation Values
123 Required
driver4_requiredSR22 Driver4 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 4 Tickets, Accidents, Violations and Claims

driver4_hasTAVCs Does Driver4 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver4_hasTAVCs = 1 then the following fields are required:

driver4_numOfIncidents The number of incidents to report for driver4.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 4, Incident 1: If driver4_numOfIncidents >= 1 then the following fields are required:

driver4_incidentType1 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate1 Date of Driver4 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType1 = 1 (Ticket) then the following fields are required:

driver4_ticket1Description Driver4 Ticket1 Description
See Driver Ticket Description Values
Required

If driver4_incidentType1 = 2 (Accident) then the following fields are required:

driver4_accident1Description Driver4 Accident1 Description
See Driver Accident Description Values
Required
driver4_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident1Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType1 = 3 (Violation) then the following fields are required:

driver4_violation1Description Driver4 Violation1 Description
See Driver Violation Description Values
Required
driver4_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType1 = 4 (Claim) then the following fields are required:

driver4_claim1Description Driver4 Claim1 Description
See Driver Claim Description Values
Required
driver4_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 2: If driver4_numOfIncidents >= 2 then the following fields are required:

driver4_incidentType2 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate2 Date of Driver4 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType2 = 1 (Ticket) then the following fields are required:

driver4_ticket2Description Driver4 Ticket2 Description
See Driver Ticket Description Values
Required

If driver4_incidentType2 = 2 (Accident) then the following fields are required:

driver4_accident2Description Driver4 Accident2 Description
See Driver Accident Description Values
Required
driver4_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident2Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType2 = 3 (Violation) then the following fields are required:

driver4_violation2Description Driver4 Violation2 Description
See Driver Violation Description Values
Required
driver4_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType2 = 4 (Claim) then the following fields are required:

driver4_claim2Description Driver4 Claim2 Description
See Driver Claim Description Values
Required
driver4_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 3: If driver4_numOfIncidents >= 3 then the following fields are required:

driver4_incidentType3 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate3 Date of Driver4 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType3 = 1 (Ticket) then the following fields are required:

driver4_ticket3Description Driver4 Ticket3 Description
See Driver Ticket Description Values
Required

If driver4_incidentType3 = 2 (Accident) then the following fields are required:

driver4_accident3Description Driver4 Accident3 Description
See Driver Accident Description Values
Required
driver4_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident3Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType3 = 3 (Violation) then the following fields are required:

driver4_violation3Description Driver4 Violation3 Description
See Driver Violation Description Values
Required
driver4_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType3 = 4 (Claim) then the following fields are required:

driver4_claim3Description Driver4 Claim3 Description
See Driver Claim Description Values
Required
driver4_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 4: If driver4_numOfIncidents >= 4 then the following fields are required:

driver4_incidentType4 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate4 Date of Driver4 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType4 = 1 (Ticket) then the following fields are required:

driver4_ticket4Description Driver4 Ticket4 Description
See Driver Ticket Description Values
Required

If driver4_incidentType4 = 2 (Accident) then the following fields are required:

driver4_accident4Description Driver4 Accident4 Description
See Driver Accident Description Values
Required
driver4_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident4Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType4 = 3 (Violation) then the following fields are required:

driver4_violation4Description Driver4 Violation4 Description
See Driver Violation Description Values
Required
driver4_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType4 = 4 (Claim) then the following fields are required:

driver4_claim4Description Driver4 Claim4 Description
See Driver Claim Description Values
Required
driver4_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Vehicle 1 Information - This entire section may be omitted if there is no vehicle1

vehicle1_year The year of vehicle1.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle1_make The make of vehicle1, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle1_model The model of vehicle1, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle1_subModel The sub-model (or trim) of vehicle1, e.g. '3.2 Sedan' Optional
vehicle1_vin The VIN of vehicle1, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle1_primaryUse The primary use of vehicle1.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle1_vehicleOwnership Ownership status of vehicle1.
1 = Owned
2 = Leased
1 Required
vehicle1_dailyMileage Daily commute mileage (one-way) of vehicle1.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle1_annualMileage Annual Mileage of vehicle1.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 2 Information - This entire section may be omitted if there is no vehicle2

vehicle2_year The year of vehicle2.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle2_make The make of vehicle2, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle2_model The model of vehicle2, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle2_subModel The sub-model (or trim) of vehicle2, e.g. '3.2 Sedan' Optional
vehicle2_vin The VIN of vehicle2, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle2_primaryUse The primary use of vehicle2.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle2_vehicleOwnership Ownership status of vehicle2.
1 = Owned
2 = Leased
1 Required
vehicle2_dailyMileage Daily commute mileage (one-way) of vehicle2.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle2_annualMileage Annual Mileage of vehicle2.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 3 Information - This entire section may be omitted if there is no vehicle3

vehicle3_year The year of vehicle3.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle3_make The make of vehicle3, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle3_model The model of vehicle3, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle3_subModel The sub-model (or trim) of vehicle3, e.g. '3.2 Sedan' Optional
vehicle3_vin The VIN of vehicle3, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle3_primaryUse The primary use of vehicle3.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle3_vehicleOwnership Ownership status of vehicle3.
1 = Owned
2 = Leased
1 Required
vehicle3_dailyMileage Daily commute mileage (one-way) of vehicle3.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle3_annualMileage Annual Mileage of vehicle3.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 4 Information - This entire section may be omitted if there is no vehicle4

vehicle4_year The year of vehicle4.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle4_make The make of vehicle4, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle4_model The model of vehicle4, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle4_subModel The sub-model (or trim) of vehicle4, e.g. '3.2 Sedan' Optional
vehicle4_vin The VIN of vehicle4, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle4_primaryUse The primary use of vehicle4.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle4_vehicleOwnership Ownership status of vehicle4.
1 = Owned
2 = Leased
1 Required
vehicle4_dailyMileage Daily commute mileage (one-way) of vehicle4.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle4_annualMileage Annual Mileage of vehicle4.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Sending a Ping Request

Ping Request Using HTTP/1.1 POST

Our PING URL is https://api.astoriacompany.com/v2/ping/. Please do not begin posting with lead_mode=1 until we have manually verified your test data (in addition to our automatic validation process), and we've explicitly notified you that your campaign has been activated within our system. Any leads posted to the live address while your campaign is still in test mode will return an error and neither be counted nor returned.

The data in the request should be URLENCODED to ensure it is received as intended.

Example Request

URL: https://api.astoriacompany.com/v2/ping/
Content-Type: application/x-www-form-urlencoded

bid_on_legs=1&lead_type=5&lead_mode=0&vendor_id=76&sub_id=6&tcpa_optin=1&tcpa_text=By+submitting+this+form...&universal_leadid=43C9E7AC-0C6A-18E5-4C78-4949E6D561AB&origination_datetime=2019-05-19+13%3A21%3A05&origination_timezone=1&ipaddress=18.234.88.196&user_agent=CCBot%2F2.0+%28https%3A%2F%2Fcommoncrawl.org%2Ffaq%2F%29&vendor_lead_id=72684225&url=http%3A%2F%2Fratechecker.com%2Fauto-insurance%2F&zip=35222&bankruptcy=0&coverageType=3&medicalPayment=5&haveInsurance=0&driver1_gender=0&driver1_dob=1994-03-13&credit_rating=2&driver1_maritalStatus=1&driver1_education=3&driver1_occupation=123&residence_type=1&years_at_residence=3&months_at_residence=0&driver1_requiredSR22=0&driver1_hasTAVCs=0&vehicle1_year=2014&vehicle1_make=Audi&vehicle1_model=A6&vehicle1_vin=1ACBC535%2AB%2A%2A%2A%2A%2A%2A%2A&vehicle1_primaryUse=5&vehicle1_vehicleOwnership=1&vehicle1_dailyMileage=3&vehicle1_annualMileage=5&vehicle_comprehensiveDeductible=4&vehicle_collisionDeductible=4

Back to contents




Ping Responses

This is exact text that will definitely be present.
This indicates variable data, or nodes that may or may not be present.

Accept:

NOTE: An 'Accepted' response on the PING does NOT indicate we purchased the lead, but ONLY that the lead has passed validation, has not been identified as a duplicate, and that we are responding with a bid for that lead. The 'Response' tag will always contain 'Accepted', but the 'Confirmation' code will differ for each response, and the 'LegPrice' may differ for each 'Leg'.

<PingResponse>
<Response>Accepted</Response>
<Confirmation>12345678901</Confirmation>
<Price>11.73</Price>
<Legs>
		<Leg>
			<LegID>222</LegID>
			<LegPrice>5.41</LegPrice>
			<CarrierID>85</CarrierID>
			<CarrierName>Farmers Union</CarrierName>
			<LicenseNumber/>
		</Leg>
		<Leg>
			<LegID>223</LegID>
			<LegPrice>6.32</LegPrice>
			<CarrierID>0</CarrierID>
			<CarrierName>Independent</CarrierName>
			<LicenseNumber>149340</LicenseNumber>
		</Leg>
</Legs>
</PingResponse>

Reject:

NOTE: There are many reasons why we might reject a ping - below you will see all the possible rejection responses. The 'Response' tag will always contain 'Rejected', and the 'Price' will always be '0.00'. The 'Confirmation' code will differ for each response.

For rejected responses, we also add two extra tags: 'Reason' tells you why the lead was rejected, and 'Message' gives some more descriptive text.

Also, where 'Reason' is 'Errors Detected', we add an 'Errors' section with a separate 'Error' node for each error - see the example below! This is designed to help you troubleshoot and fix any errors found.

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>No Buyers Found</Reason>
<Message>There were no buyers available to bid on this lead</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>No Buyers Found</Reason>
<Message>Bids do not meet minimum_price requirement</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Maintenance Mode</Reason>
<Message>Our system is currently in maintenance mode</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Post data is empty</Reason>
<Message>Please check your integration</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_type</Reason>
<Message>Please pass a valid lead_type as per our specs</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_type for this vendor_id</Reason>
<Message>You are not currently approved to send leads of the given lead_type</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_mode</Reason>
<Message>Please ensure lead_mode is either '0' for TEST or '1' for LIVE</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid vendor_id</Reason>
<Message>Please check the vendor_id is correct</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Provided vendor_id is in TEST MODE</Reason>
<Message>Please contact us if you believe your account should be in LIVE MODE</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Daily Cap Exhausted</Reason>
<Message>Please contact us to increase your daily cap</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Per Minute Cap Exhausted</Reason>
<Message>Please contact us to increase your per minute cap</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Errors Detected</Reason>
<Message>The following errors were detected in this lead:</Message>
<Errors>
<Error>1</Error>
<Error>2</Error>
<Error>3</Error>
</Errors>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Duplicate Lead</Reason>
<Message>Lead was identified as a duplicate in our system</Message>
<Legs/>
</PingResponse>

<PingResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Blacklisted Data</Reason>
<Message>The lead matches data on our internal blacklist - please investigate the lead source</Message>
<Legs/>
</PingResponse>

Back to contents




Sample Ping Code

Here is some sample PHP code to help you create your call to our API. This is simple stuff, so you should be able to readily convery it into another programming language if necessary.

$apiUrl = 'https://api.astoriacompany.com/v2/ping/';

$headers = array('Content-Type: application/x-www-form-urlencoded');

$request = 'bid_on_legs=1&lead_type=5&lead_mode=0&vendor_id=76&sub_id=6&tcpa_optin=1&tcpa_text=By+submitting+this+form...&universal_leadid=43C9E7AC-0C6A-18E5-4C78-4949E6D561AB&origination_datetime=2019-05-19+13%3A21%3A05&origination_timezone=1&ipaddress=18.234.88.196&user_agent=CCBot%2F2.0+%28https%3A%2F%2Fcommoncrawl.org%2Ffaq%2F%29&vendor_lead_id=72684225&url=http%3A%2F%2Fratechecker.com%2Fauto-insurance%2F&zip=35222&bankruptcy=0&coverageType=3&medicalPayment=5&haveInsurance=0&driver1_gender=0&driver1_dob=1994-03-13&credit_rating=2&driver1_maritalStatus=1&driver1_education=3&driver1_occupation=123&residence_type=1&years_at_residence=3&months_at_residence=0&driver1_requiredSR22=0&driver1_hasTAVCs=0&vehicle1_year=2014&vehicle1_make=Audi&vehicle1_model=A6&vehicle1_vin=1ACBC535%2AB%2A%2A%2A%2A%2A%2A%2A&vehicle1_primaryUse=5&vehicle1_vehicleOwnership=1&vehicle1_dailyMileage=3&vehicle1_annualMileage=5&vehicle_comprehensiveDeductible=4&vehicle_collisionDeductible=4';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);

$response = curl_exec($ch);
curl_close($ch);

Back to contents




Post:

What is a Post?

A Post is a call to our API with all of the lead data INCLUDING the PII. It's purpose is to attempt delivery of the actual lead to us, for the price established on the ping.

Field names and acceptable values

The absence of any required field (Required) will result in an error. If you do not collect the data for a required field, please refer to the 'Suggested Default' column.
Preferred fields (Preferred) may be omitted, but doing so could reduce a lead's chances of finding a buyer.
Optional fields (Optional) can be omitted without any major impact.

To make things easier for you, we have highlighted in green the additional fields that were not included in the Ping, but need to be added for the Post to pass validation.

Field Contents Suggested Default Required?
bid_on_leg Determines that this is a Bid on Legs (BoL) lead.
MUST be '1' to receive a BoL formatted response.
1 Required
confirmation_id Astoria provided <Confirmation> code from corresponding ping repsonse.
MUST be provided on Post, else it will be treated as a fresh Ping.
Required
leg_id_list Comma separated list of Astoria provided <LegID>'s from corresponding BoL ping repsonse.
MUST be provided on Post, else it will be rejected.
Required
lead_type Determines the type of lead.
MUST be '5' for Auto Insurance (Shared / Bid On Legs)
5 Required
lead_mode Determines if the lead should be treated as a test lead or a live lead.
0 = TEST LEAD
1 = LIVE LEAD
Click here for full testing instructions.
Required
vendor_id This is the VID code you were provided by Astoria; if you do not know it, please contact us.
Please ensure you are using the correct code, otherwise your leads may be credited to another partner!
Required
sub_id Code of your choosing for your own tracking purposes, e.g. '123-ABC'
This should enable us to distinguish your lead sources from each other, so that we can optimize lead flow to buyers.
There is a maximum length of 35 characters, and it may only contain letters, numbers, underscores and hyphens.
Required
tcpa_optin Indicates whether or not the consumer was presented with, and accepted, unambiguous consent to be contacted via automated telephone systems pursuant to TCPA requirements.
0 = No
1 = Yes
Click here for more information.
0 Required
tcpa_text Contains the TCPA language the consumer was presented with on the form where their information was submitted,
e.g. 'By submitting this form…'
Click here for more information.
Required
universal_leadid Unique LeadiD as generated by LeadiD.com,
e.g. '43C9E7AC-0C6A-18E5-4C78-4949E6D561AB'
Required
origination_datetime Date/time when lead was submitted by consumer, in format 'YYYY-MM-DD hh:mm:ss',
e.g. '2019-05-19 13:21:05'
Required
origination_timezone The timezone for the date/time passed in origination_datetime.
1 = EST / EDT
2 = CST / CDT
3 = MST / MDT
4 = PST / PDT
Required
ipaddress Applicants IP address, e.g. '18.234.88.196' Required
user_agent The user agent string for the browser used by the applicant when their information was submitted,
e.g. 'CCBot/2.0 (https://commoncrawl.org/faq/)'
Preferred
vendor_lead_id Your internal ID for this lead (useful if we need to contact you about a specific lead and when processing returns),
e.g. '72684225'
Preferred
url URL of form where lead was generated, e.g. 'http://ratechecker.com/auto-insurance/' Preferred
minimum_price Minimum price you would accept for this lead, no $ symbol or commas, e.g. '2.00'
NOTE: For test leads (i.e. where lead_mode=0), our 'buyers' return very low prices (for safety). If you choose to include this optional parameter, then please set it to just '0.01' when testing to ensure you receive the expected responses.
WARNING: Setting a minimum_price will cause you to sell fewer leads!
Optional
email Email address Valid Email Address Required
address Street Address   Required
zip Valid 5-digit US Zip Code.
Can be used when lead_mode=0 to influence test results.
Click here for full testing instructions.
Required
primary_phone Primary phone number, exactly 10 digits (3 For PhoneAreaCode, 3 For PhoneExchange and 4 For PhoneSuffix ) no (), -, or spaces Required
secondary_phone Secondary phone number, exactly 10 digits (3 For PhoneAreaCode, 3 For PhoneExchange and 4 For PhoneSuffix ) no (), -, or spaces Optional
residence_type Primary applicants residence status.
0 = Own
1 = Rent
1 Required
years_at_residence Primary applicants years at residence.
0 = 0 Years
1 = 1 Year
2 = 2 Years
3 = 3 Years
4 = 4 Years
5 = 5 Years
6 = 6 Years
7 = 7 Years
8 = 8 Years
9 = 9 Years
10 = 10 or more Years
3 Required
months_at_residence Primary applicants months at residence.
0 = 0 Months
1 = 1 Month
2 = 2 Months
3 = 3 Months
4 = 4 Months
5 = 5 Months
6 = 6 Months
7 = 7 Months
8 = 8 Months
9 = 9 Months
10 = 10 Months
11 = 11 Months
0 Required
credit_rating Primary applicants credit rating.
1 = Excellent
2 = Good
3 = Fair
4 = Poor
2 Required
bankruptcy Has primary applicant filed for bankruptcy in the past 7 years?
0 = No
1 = Yes
0 Required
coverageType Coverage Type.
1 = Superior ($250k/$500k Injury, $100k Property)
2 = Standard ($100k/$300k Injury, $50k Property)
3 = Basic ($50k/$100k Injury, $25k Property)
4 = State Minimum
3 Required
vehicle_comprehensiveDeductible Comprehensive Deductible for policy.
1 = $0
2 = $50
3 = $100
4 = $250
5 = $500
6 = $1,000
7 = $2,500
8 = $5,000
4 Required
vehicle_collisionDeductible Collision Deductible for policy.
1 = $0
2 = $50
3 = $100
4 = $250
5 = $500
6 = $1,000
7 = $2,500
8 = $5,000
4 Required
medicalPayment Amount of Medical Coverage.
1 = $0
2 = $500
3 = $1,000
4 = $2,000
5 = $5,000
6 = $25,000
7 = $50,000
8 = $100,000
5 Required
haveInsurance Indicates whether driver1 has a current auto insurance policy or not.
Note: May include auto insurance policies that have expired no more than 30 days in the past.
0 = No
1 = Yes
0 Required

If haveInsurance = 1 (Yes) then the following fields are required.

insuranceCompany Driver1's current insurance company - see Insurance Company Values
Note that we do NOT recommend a default mapping of 'Other' for this field as doing so will result in very few leads being accepted.
Required
current_policy_start_date Driver1's current policy start date, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required
current_policy_expiration_date Driver1's current policy expiration date, in the format YYYY-MM-DD, e.g. '2019-06-02'
Note: Could be a date no more than 30 days in the past, the current date, or a future date.
Required
continuously_insured_period Driver1's period of continuous auto insurance coverage.
1 = Less than 6 Months
2 = 6 Months to 1 Year
3 = 1 Year
4 = 2 Years
5 = 3 Years
6 = 4 Years
7 = 5 Years
8 = 6+ Years
1 Required

Driver 1 Information - This section is Required

driver1_firstname Driver1 first name. Required
driver1_lastname Driver1 last name. Required
driver1_gender Driver1 gender.
0 = Male
1 = Female
0 Required
driver1_dob Driver1 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver1_maritalStatus Driver1 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver1_education Driver1 education level.
See Driver Education Level Values
123 Required
driver1_occupation Driver1 occupation.
See Driver Occupation Values
123 Required
driver1_requiredSR22 Driver1 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 1 Tickets, Accidents, Violations and Claims

driver1_hasTAVCs Does Driver1 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver1_hasTAVCs = 1 then the following fields are required:

driver1_numOfIncidents The number of incidents to report for driver1.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 1, Incident 1: If driver1_numOfIncidents >= 1 then the following fields are required:

driver1_incidentType1 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate1 Date of Driver1 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType1 = 1 (Ticket) then the following fields are required:

driver1_ticket1Description Driver1 Ticket1 Description
See Driver Ticket Description Values
Required

If driver1_incidentType1 = 2 (Accident) then the following fields are required:

driver1_accident1Description Driver1 Accident1 Description
See Driver Accident Description Values
Required
driver1_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident1Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType1 = 3 (Violation) then the following fields are required:

driver1_violation1Description Driver1 Violation1 Description
See Driver Violation Description Values
Required
driver1_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType1 = 4 (Claim) then the following fields are required:

driver1_claim1Description Driver1 Claim1 Description
See Driver Claim Description Values
Required
driver1_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 2: If driver1_numOfIncidents >= 2 then the following fields are required:

driver1_incidentType2 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate2 Date of Driver1 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType2 = 1 (Ticket) then the following fields are required:

driver1_ticket2Description Driver1 Ticket2 Description
See Driver Ticket Description Values
Required

If driver1_incidentType2 = 2 (Accident) then the following fields are required:

driver1_accident2Description Driver1 Accident2 Description
See Driver Accident Description Values
Required
driver1_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident2Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType2 = 3 (Violation) then the following fields are required:

driver1_violation2Description Driver1 Violation2 Description
See Driver Violation Description Values
Required
driver1_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType2 = 4 (Claim) then the following fields are required:

driver1_claim2Description Driver1 Claim2 Description
See Driver Claim Description Values
Required
driver1_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 3: If driver1_numOfIncidents >= 3 then the following fields are required:

driver1_incidentType3 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate3 Date of Driver1 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType3 = 1 (Ticket) then the following fields are required:

driver1_ticket3Description Driver1 Ticket3 Description
See Driver Ticket Description Values
Required

If driver1_incidentType3 = 2 (Accident) then the following fields are required:

driver1_accident3Description Driver1 Accident3 Description
See Driver Accident Description Values
Required
driver1_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident3Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType3 = 3 (Violation) then the following fields are required:

driver1_violation3Description Driver1 Violation3 Description
See Driver Violation Description Values
Required
driver1_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType3 = 4 (Claim) then the following fields are required:

driver1_claim3Description Driver1 Claim3 Description
See Driver Claim Description Values
Required
driver1_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 1, Incident 4: If driver1_numOfIncidents >= 4 then the following fields are required:

driver1_incidentType4 The type of incident to report for driver1.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver1_incidentDate4 Date of Driver1 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver1_incidentType4 = 1 (Ticket) then the following fields are required:

driver1_ticket4Description Driver1 Ticket4 Description
See Driver Ticket Description Values
Required

If driver1_incidentType4 = 2 (Accident) then the following fields are required:

driver1_accident4Description Driver1 Accident4 Description
See Driver Accident Description Values
Required
driver1_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver1_accident4Atfault Was Driver1 at fault?
0 = No
1 = Yes
0 Required
driver1_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver1_incidentType4 = 3 (Violation) then the following fields are required:

driver1_violation4Description Driver1 Violation4 Description
See Driver Violation Description Values
Required
driver1_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver1_incidentType4 = 4 (Claim) then the following fields are required:

driver1_claim4Description Driver1 Claim4 Description
See Driver Claim Description Values
Required
driver1_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2 Information - This section is Preferred if driver1_maritalStatus = 2 (Married), but may be omitted if unknown

driver2_firstname Driver2 first name. Required
driver2_lastname Driver2 last name. Required
driver2_gender Driver2 gender.
0 = Male
1 = Female
0 Required
driver2_dob Driver2 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver2_relationshipToApplicant Driver2 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver2_maritalStatus Driver2 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver2_education Driver2 education level.
See Driver Education Level Values
123 Required
driver2_occupation Driver2 occupation.
See Driver Occupation Values
123 Required
driver2_requiredSR22 Driver2 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 2 Tickets, Accidents, Violations and Claims

driver2_hasTAVCs Does Driver2 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver2_hasTAVCs = 1 then the following fields are required:

driver2_numOfIncidents The number of incidents to report for driver2.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 2, Incident 1: If driver2_numOfIncidents >= 1 then the following fields are required:

driver2_incidentType1 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate1 Date of Driver2 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType1 = 1 (Ticket) then the following fields are required:

driver2_ticket1Description Driver2 Ticket1 Description
See Driver Ticket Description Values
Required

If driver2_incidentType1 = 2 (Accident) then the following fields are required:

driver2_accident1Description Driver2 Accident1 Description
See Driver Accident Description Values
Required
driver2_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident1Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType1 = 3 (Violation) then the following fields are required:

driver2_violation1Description Driver2 Violation1 Description
See Driver Violation Description Values
Required
driver2_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType1 = 4 (Claim) then the following fields are required:

driver2_claim1Description Driver2 Claim1 Description
See Driver Claim Description Values
Required
driver2_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 2: If driver2_numOfIncidents >= 2 then the following fields are required:

driver2_incidentType2 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate2 Date of Driver2 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType2 = 1 (Ticket) then the following fields are required:

driver2_ticket2Description Driver2 Ticket2 Description
See Driver Ticket Description Values
Required

If driver2_incidentType2 = 2 (Accident) then the following fields are required:

driver2_accident2Description Driver2 Accident2 Description
See Driver Accident Description Values
Required
driver2_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident2Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType2 = 3 (Violation) then the following fields are required:

driver2_violation2Description Driver2 Violation2 Description
See Driver Violation Description Values
Required
driver2_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType2 = 4 (Claim) then the following fields are required:

driver2_claim2Description Driver2 Claim2 Description
See Driver Claim Description Values
Required
driver2_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 3: If driver2_numOfIncidents >= 3 then the following fields are required:

driver2_incidentType3 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate3 Date of Driver2 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType3 = 1 (Ticket) then the following fields are required:

driver2_ticket3Description Driver2 Ticket3 Description
See Driver Ticket Description Values
Required

If driver2_incidentType3 = 2 (Accident) then the following fields are required:

driver2_accident3Description Driver2 Accident3 Description
See Driver Accident Description Values
Required
driver2_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident3Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType3 = 3 (Violation) then the following fields are required:

driver2_violation3Description Driver2 Violation3 Description
See Driver Violation Description Values
Required
driver2_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType3 = 4 (Claim) then the following fields are required:

driver2_claim3Description Driver2 Claim3 Description
See Driver Claim Description Values
Required
driver2_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 2, Incident 4: If driver2_numOfIncidents >= 4 then the following fields are required:

driver2_incidentType4 The type of incident to report for driver2.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver2_incidentDate4 Date of Driver2 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver2_incidentType4 = 1 (Ticket) then the following fields are required:

driver2_ticket4Description Driver2 Ticket4 Description
See Driver Ticket Description Values
Required

If driver2_incidentType4 = 2 (Accident) then the following fields are required:

driver2_accident4Description Driver2 Accident4 Description
See Driver Accident Description Values
Required
driver2_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver2_accident4Atfault Was Driver2 at fault?
0 = No
1 = Yes
0 Required
driver2_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver2_incidentType4 = 3 (Violation) then the following fields are required:

driver2_violation4Description Driver2 Violation4 Description
See Driver Violation Description Values
Required
driver2_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver2_incidentType4 = 4 (Claim) then the following fields are required:

driver2_claim4Description Driver2 Claim4 Description
See Driver Claim Description Values
Required
driver2_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3 Information - This entire section may be omitted if there is no driver3

driver3_firstname Driver3 first name. Required
driver3_lastname Driver3 last name. Required
driver3_gender Driver3 gender.
0 = Male
1 = Female
0 Required
driver3_dob Driver3 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver3_relationshipToApplicant Driver3 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver3_maritalStatus Driver3 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver3_education Driver3 education level.
See Driver Education Level Values
123 Required
driver3_occupation Driver3 occupation.
See Driver Occupation Values
123 Required
driver3_requiredSR22 Driver3 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 3 Tickets, Accidents, Violations and Claims

driver3_hasTAVCs Does Driver3 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver3_hasTAVCs = 1 then the following fields are required:

driver3_numOfIncidents The number of incidents to report for driver3.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 3, Incident 1: If driver3_numOfIncidents >= 1 then the following fields are required:

driver3_incidentType1 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate1 Date of Driver3 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType1 = 1 (Ticket) then the following fields are required:

driver3_ticket1Description Driver3 Ticket1 Description
See Driver Ticket Description Values
Required

If driver3_incidentType1 = 2 (Accident) then the following fields are required:

driver3_accident1Description Driver3 Accident1 Description
See Driver Accident Description Values
Required
driver3_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident1Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType1 = 3 (Violation) then the following fields are required:

driver3_violation1Description Driver3 Violation1 Description
See Driver Violation Description Values
Required
driver3_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType1 = 4 (Claim) then the following fields are required:

driver3_claim1Description Driver3 Claim1 Description
See Driver Claim Description Values
Required
driver3_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 2: If driver3_numOfIncidents >= 2 then the following fields are required:

driver3_incidentType2 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate2 Date of Driver3 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType2 = 1 (Ticket) then the following fields are required:

driver3_ticket2Description Driver3 Ticket2 Description
See Driver Ticket Description Values
Required

If driver3_incidentType2 = 2 (Accident) then the following fields are required:

driver3_accident2Description Driver3 Accident2 Description
See Driver Accident Description Values
Required
driver3_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident2Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType2 = 3 (Violation) then the following fields are required:

driver3_violation2Description Driver3 Violation2 Description
See Driver Violation Description Values
Required
driver3_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType2 = 4 (Claim) then the following fields are required:

driver3_claim2Description Driver3 Claim2 Description
See Driver Claim Description Values
Required
driver3_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 3: If driver3_numOfIncidents >= 3 then the following fields are required:

driver3_incidentType3 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate3 Date of Driver3 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType3 = 1 (Ticket) then the following fields are required:

driver3_ticket3Description Driver3 Ticket3 Description
See Driver Ticket Description Values
Required

If driver3_incidentType3 = 2 (Accident) then the following fields are required:

driver3_accident3Description Driver3 Accident3 Description
See Driver Accident Description Values
Required
driver3_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident3Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType3 = 3 (Violation) then the following fields are required:

driver3_violation3Description Driver3 Violation3 Description
See Driver Violation Description Values
Required
driver3_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType3 = 4 (Claim) then the following fields are required:

driver3_claim3Description Driver3 Claim3 Description
See Driver Claim Description Values
Required
driver3_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 3, Incident 4: If driver3_numOfIncidents >= 4 then the following fields are required:

driver3_incidentType4 The type of incident to report for driver3.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver3_incidentDate4 Date of Driver3 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver3_incidentType4 = 1 (Ticket) then the following fields are required:

driver3_ticket4Description Driver3 Ticket4 Description
See Driver Ticket Description Values
Required

If driver3_incidentType4 = 2 (Accident) then the following fields are required:

driver3_accident4Description Driver3 Accident4 Description
See Driver Accident Description Values
Required
driver3_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver3_accident4Atfault Was Driver3 at fault?
0 = No
1 = Yes
0 Required
driver3_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver3_incidentType4 = 3 (Violation) then the following fields are required:

driver3_violation4Description Driver3 Violation4 Description
See Driver Violation Description Values
Required
driver3_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver3_incidentType4 = 4 (Claim) then the following fields are required:

driver3_claim4Description Driver3 Claim4 Description
See Driver Claim Description Values
Required
driver3_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4 Information - This entire section may be omitted if there is no driver4

driver4_firstname Driver4 first name. Required
driver4_lastname Driver4 last name. Required
driver4_gender Driver4 gender.
0 = Male
1 = Female
0 Required
driver4_dob Driver4 date of birth, in the format YYYY-MM-DD, e.g. '1994-03-13' Required
driver4_relationshipToApplicant Driver4 relationship to Driver1.
1 = Spouse
2 = Child
3 = Sibling
4 = Parent
5 = Grandparent
6 = Grandchild
7 = Other
7 Required
driver4_maritalStatus Driver4 marital status.
1 = Single
2 = Married
3 = Separated
4 = Divorced
5 = Domestic Partner
6 = Widowed
1 Required
driver4_education Driver4 education level.
See Driver Education Level Values
123 Required
driver4_occupation Driver4 occupation.
See Driver Occupation Values
123 Required
driver4_requiredSR22 Driver4 SR22 status.
0 = SR22 NOT required
1 = SR22 Required
0 Required

Driver 4 Tickets, Accidents, Violations and Claims

driver4_hasTAVCs Does Driver4 have any Tickets, Accidents, Violations or Claims?
0 = No
1 = Yes
Required

If driver4_hasTAVCs = 1 then the following fields are required:

driver4_numOfIncidents The number of incidents to report for driver4.
1 = 1 incident
2 = 2 incidents
3 = 3 incidents
4 = 4 incidents
Required

Driver 4, Incident 1: If driver4_numOfIncidents >= 1 then the following fields are required:

driver4_incidentType1 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate1 Date of Driver4 Incident1, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType1 = 1 (Ticket) then the following fields are required:

driver4_ticket1Description Driver4 Ticket1 Description
See Driver Ticket Description Values
Required

If driver4_incidentType1 = 2 (Accident) then the following fields are required:

driver4_accident1Description Driver4 Accident1 Description
See Driver Accident Description Values
Required
driver4_accident1Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident1Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident1Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType1 = 3 (Violation) then the following fields are required:

driver4_violation1Description Driver4 Violation1 Description
See Driver Violation Description Values
Required
driver4_violation1State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType1 = 4 (Claim) then the following fields are required:

driver4_claim1Description Driver4 Claim1 Description
See Driver Claim Description Values
Required
driver4_claim1PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 2: If driver4_numOfIncidents >= 2 then the following fields are required:

driver4_incidentType2 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate2 Date of Driver4 Incident2, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType2 = 1 (Ticket) then the following fields are required:

driver4_ticket2Description Driver4 Ticket2 Description
See Driver Ticket Description Values
Required

If driver4_incidentType2 = 2 (Accident) then the following fields are required:

driver4_accident2Description Driver4 Accident2 Description
See Driver Accident Description Values
Required
driver4_accident2Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident2Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident2Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType2 = 3 (Violation) then the following fields are required:

driver4_violation2Description Driver4 Violation2 Description
See Driver Violation Description Values
Required
driver4_violation2State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType2 = 4 (Claim) then the following fields are required:

driver4_claim2Description Driver4 Claim2 Description
See Driver Claim Description Values
Required
driver4_claim2PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 3: If driver4_numOfIncidents >= 3 then the following fields are required:

driver4_incidentType3 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate3 Date of Driver4 Incident3, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType3 = 1 (Ticket) then the following fields are required:

driver4_ticket3Description Driver4 Ticket3 Description
See Driver Ticket Description Values
Required

If driver4_incidentType3 = 2 (Accident) then the following fields are required:

driver4_accident3Description Driver4 Accident3 Description
See Driver Accident Description Values
Required
driver4_accident3Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident3Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident3Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType3 = 3 (Violation) then the following fields are required:

driver4_violation3Description Driver4 Violation3 Description
See Driver Violation Description Values
Required
driver4_violation3State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType3 = 4 (Claim) then the following fields are required:

driver4_claim3Description Driver4 Claim3 Description
See Driver Claim Description Values
Required
driver4_claim3PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Driver 4, Incident 4: If driver4_numOfIncidents >= 4 then the following fields are required:

driver4_incidentType4 The type of incident to report for driver4.
1 = Ticket
2 = Accident
3 = Violation
4 = Claim
Required
driver4_incidentDate4 Date of Driver4 Incident4, in the format YYYY-MM-DD, e.g. '2018-12-02'
Note: Should be a date in the past.
Required

If driver4_incidentType4 = 1 (Ticket) then the following fields are required:

driver4_ticket4Description Driver4 Ticket4 Description
See Driver Ticket Description Values
Required

If driver4_incidentType4 = 2 (Accident) then the following fields are required:

driver4_accident4Description Driver4 Accident4 Description
See Driver Accident Description Values
Required
driver4_accident4Damage What was damaged?
1 = People
2 = Property
3 = Both
4 = Not Applicable
Required
driver4_accident4Atfault Was Driver4 at fault?
0 = No
1 = Yes
0 Required
driver4_accident4Amount Total claim amount - no commas or dollar symbol, e.g. '5000.00' or '5000'. Required

If driver4_incidentType4 = 3 (Violation) then the following fields are required:

driver4_violation4Description Driver4 Violation4 Description
See Driver Violation Description Values
Required
driver4_violation4State State in which violation was committed.
Two captial letters (NY, CA, etc).
Required

If driver4_incidentType4 = 4 (Claim) then the following fields are required:

driver4_claim4Description Driver4 Claim4 Description
See Driver Claim Description Values
Required
driver4_claim4PaidAmount Total claim amount to nearest dollar - no commas, dollar symbol or decimal point, e.g. '5000'. Required

Vehicle 1 Information - This entire section may be omitted if there is no vehicle1

vehicle1_year The year of vehicle1.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle1_make The make of vehicle1, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle1_model The model of vehicle1, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle1_subModel The sub-model (or trim) of vehicle1, e.g. '3.2 Sedan' Optional
vehicle1_vin The VIN of vehicle1, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle1_primaryUse The primary use of vehicle1.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle1_vehicleOwnership Ownership status of vehicle1.
1 = Owned
2 = Leased
1 Required
vehicle1_dailyMileage Daily commute mileage (one-way) of vehicle1.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle1_annualMileage Annual Mileage of vehicle1.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 2 Information - This entire section may be omitted if there is no vehicle2

vehicle2_year The year of vehicle2.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle2_make The make of vehicle2, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle2_model The model of vehicle2, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle2_subModel The sub-model (or trim) of vehicle2, e.g. '3.2 Sedan' Optional
vehicle2_vin The VIN of vehicle2, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle2_primaryUse The primary use of vehicle2.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle2_vehicleOwnership Ownership status of vehicle2.
1 = Owned
2 = Leased
1 Required
vehicle2_dailyMileage Daily commute mileage (one-way) of vehicle2.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle2_annualMileage Annual Mileage of vehicle2.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 3 Information - This entire section may be omitted if there is no vehicle3

vehicle3_year The year of vehicle3.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle3_make The make of vehicle3, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle3_model The model of vehicle3, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle3_subModel The sub-model (or trim) of vehicle3, e.g. '3.2 Sedan' Optional
vehicle3_vin The VIN of vehicle3, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle3_primaryUse The primary use of vehicle3.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle3_vehicleOwnership Ownership status of vehicle3.
1 = Owned
2 = Leased
1 Required
vehicle3_dailyMileage Daily commute mileage (one-way) of vehicle3.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle3_annualMileage Annual Mileage of vehicle3.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Vehicle 4 Information - This entire section may be omitted if there is no vehicle4

vehicle4_year The year of vehicle4.
From last 30 years, i.e. between 1989 and 2019, inclusive.
Note that 2020 would be acceptable from August 1st, 2019.
Required
vehicle4_make The make of vehicle4, e.g. 'Audi'
Click here to learn about our Vehicle API
Required
vehicle4_model The model of vehicle4, e.g. 'A6'
Click here to learn about our Vehicle API
Required
vehicle4_subModel The sub-model (or trim) of vehicle4, e.g. '3.2 Sedan' Optional
vehicle4_vin The VIN of vehicle4, e.g. '1ACBC535*B*******'
Not required if you use our Vehicle API to get a valid make and model.
Preferred
vehicle4_primaryUse The primary use of vehicle4.
1 = Business
2 = Commute Work
3 = Commute School
4 = Pleasure
5 = Commute Varies
5 Required
vehicle4_vehicleOwnership Ownership status of vehicle4.
1 = Owned
2 = Leased
1 Required
vehicle4_dailyMileage Daily commute mileage (one-way) of vehicle4.
1 = up to 3 miles
2 = up to 5 miles
3 = up to 9 miles
4 = up to 19 miles
5 = up to 50 miles
6 = 51+ miles
3 Required
vehicle4_annualMileage Annual Mileage of vehicle4.
1 = 1 to 5,000 miles
2 = 5,001 to 7,500 miles
3 = 7,501 to 10,000 miles
4 = 10,001 to 12,500 miles
5 = 12,501 to 15,000 miles
6 = 15,001 to 18,000 miles
7 = 18,001 to 25,000 miles
8 = 25,001 to 50,000 miles
9 = 50,001+ miles
5 Required

Sending a Post Request

Post Request Using HTTP/1.1 POST

Our POST URL is https://api.astoriacompany.com/v2/post/. Please do not begin posting with lead_mode=1 until we have manually verified your test data (in addition to our automatic validation process), and we've explicitly notified you that your campaign has been activated within our system. Any leads posted to the live address while your campaign is still in test mode will return an error and neither be counted nor returned.

The data in the request should be URLENCODED to ensure it is received as intended.

Example Request

URL: https://api.astoriacompany.com/v2/post/
Content-Type: application/x-www-form-urlencoded

bid_on_legs=1&leg_id_list=222%2C223&lead_type=5&lead_mode=0&vendor_id=76&sub_id=6&tcpa_optin=1&tcpa_text=By+submitting+this+form...&universal_leadid=43C9E7AC-0C6A-18E5-4C78-4949E6D561AB&origination_datetime=2019-05-19+13%3A21%3A05&origination_timezone=1&ipaddress=18.234.88.196&user_agent=CCBot%2F2.0+%28https%3A%2F%2Fcommoncrawl.org%2Ffaq%2F%29&vendor_lead_id=72684225&url=http%3A%2F%2Fratechecker.com%2Fauto-insurance%2F&zip=35222&bankruptcy=0&coverageType=3&medicalPayment=5&haveInsurance=0&driver1_gender=0&driver1_dob=1994-03-13&credit_rating=2&driver1_maritalStatus=1&driver1_education=3&driver1_occupation=123&residence_type=1&years_at_residence=3&months_at_residence=0&driver1_requiredSR22=0&driver1_hasTAVCs=0&vehicle1_year=2014&vehicle1_make=Audi&vehicle1_model=A6&vehicle1_vin=1ACBC535%2AB%2A%2A%2A%2A%2A%2A%2A&vehicle1_primaryUse=5&vehicle1_vehicleOwnership=1&vehicle1_dailyMileage=3&vehicle1_annualMileage=5&vehicle_comprehensiveDeductible=4&vehicle_collisionDeductible=4&confirmation_id=12345&email=test%40test.com&address=123+High+Street&primary_phone=6105551212&driver1_firstname=John&driver1_lastname=Smith

Back to contents




Post Responses

This is exact text that will definitely be present.
This indicates variable data, or nodes that may or may not be present.

Accept:

NOTE: An 'Accept' response on the POST indicates we HAVE purchased AT LEAST ONE LEG of that lead (BUT NOT NECESSARILY ALL OF THE LEGS). The 'Confirmation' code will differ for each response, and the 'LegPrice' may differ for each 'Leg'. The 'LegResponse' tag for any accepted 'Leg' will contain 'Accepted', while for rejected 'Leg's it will contain 'Rejected'. PLEASE TAKE CARE to ensure you correctly identify which 'Leg's were accepted, and which were rejected.

<PostResponse>
<Response>Accepted</Response>
<Confirmation>12345678901</Confirmation>
<Price>5.41</Price>
	<Legs>
		<Leg>
			<LegID>222</LegID>
			<LegPrice>5.41</LegPrice>
			<LegResponse>Accepted</LegResponse>
		</Leg>
		<Leg>
			<LegID>225</LegID>
			<LegPrice>0.00</LegPrice>
			<LegResponse>Rejected</LegResponse>
		</Leg>
	</Legs>
</PostResponse>

Reject:

NOTE: There are many reasons why we might reject a post - below you will see all the possible rejection responses. The 'Response' tag will always contain 'Rejected', and the 'Price' will always be '0.00'. The 'Confirmation' code will differ for each response.

For rejected responses, we also add two extra tags: 'Reason' tells you why the lead was rejected, and 'Message' gives some more descriptive text.

Also, where 'Reason' is 'Errors Detected', we add an 'Errors' section with a separate 'Error' node for each error - see the example below! This is designed to help you troubleshoot and fix any errors found.

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Unable to Monetize</Reason>
<Message>All buyers rejected this lead (IF POSSIBLE, WE WILL ATTEMPT TO EXPLAIN WHY HERE)</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Unable to Monetize</Reason>
<Message>Bids do not meet minimum_price requirement</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Maintenance Mode</Reason>
<Message>Our system is currently in maintenance mode</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Post data is empty</Reason>
<Message>Please check your integration</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid Confirmation ID</Reason>
<Message>You have passed a confirmation_id which is invalid</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_type</Reason>
<Message>Please pass a valid lead_type as per our specs</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_type for this vendor_id</Reason>
<Message>You are not currently approved to send leads of the given lead_type</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid lead_mode</Reason>
<Message>Please ensure lead_mode is either '0' for TEST or '1' for LIVE</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Invalid vendor_id</Reason>
<Message>Please check the vendor_id is correct</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Provided vendor_id is in TEST MODE</Reason>
<Message>Please contact us if you believe your account should be in LIVE MODE</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Daily Cap Exhausted</Reason>
<Message>Please contact us to increase your daily cap</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Per Minute Cap Exhausted</Reason>
<Message>Please contact us to increase your per minute cap</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Errors Detected</Reason>
<Message>The following errors were detected in this lead:</Message>
<Errors>
<Error>1</Error>
<Error>2</Error>
<Error>3</Error>
</Errors>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Duplicate Lead</Reason>
<Message>Lead was identified as a duplicate in our system</Message>
<Legs/>
</PostResponse>

<PostResponse>
<Response>Rejected</Response>
<Confirmation>12345678901</Confirmation>
<Price>0.00</Price>
<Reason>Blacklisted Data</Reason>
<Message>The lead matches data on our internal blacklist - please investigate the lead source</Message>
<Legs/>
</PostResponse>

Back to contents




Sample Post Code

Here is some sample PHP code to help you create your call to our API. This is simple stuff, so you should be able to readily convery it into another programming language if necessary.

$apiUrl = 'https://api.astoriacompany.com/v2/post/';
$headers = array('Content-Type: application/x-www-form-urlencoded');

$request = 'bid_on_legs=1&leg_id_list=222%2C223&lead_type=5&lead_mode=0&vendor_id=76&sub_id=6&tcpa_optin=1&tcpa_text=By+submitting+this+form...&universal_leadid=43C9E7AC-0C6A-18E5-4C78-4949E6D561AB&origination_datetime=2019-05-19+13%3A21%3A05&origination_timezone=1&ipaddress=18.234.88.196&user_agent=CCBot%2F2.0+%28https%3A%2F%2Fcommoncrawl.org%2Ffaq%2F%29&vendor_lead_id=72684225&url=http%3A%2F%2Fratechecker.com%2Fauto-insurance%2F&zip=35222&bankruptcy=0&coverageType=3&medicalPayment=5&haveInsurance=0&driver1_gender=0&driver1_dob=1994-03-13&credit_rating=2&driver1_maritalStatus=1&driver1_education=3&driver1_occupation=123&residence_type=1&years_at_residence=3&months_at_residence=0&driver1_requiredSR22=0&driver1_hasTAVCs=0&vehicle1_year=2014&vehicle1_make=Audi&vehicle1_model=A6&vehicle1_vin=1ACBC535%2AB%2A%2A%2A%2A%2A%2A%2A&vehicle1_primaryUse=5&vehicle1_vehicleOwnership=1&vehicle1_dailyMileage=3&vehicle1_annualMileage=5&vehicle_comprehensiveDeductible=4&vehicle_collisionDeductible=4&confirmation_id=12345&email=test%40test.com&address=123+High+Street&primary_phone=6105551212&driver1_firstname=John&driver1_lastname=Smith';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);

$response = curl_exec($ch);
curl_close($ch);

Back to contents




Common Mistakes

  • Values must be URL encoded. For example, james.doe@example.com should be james.doe%40example.com and 4 Pennsylvania Plaza should be 4+Pennsylvania+Plaza.
  • All field names and explicitly allowed values (employment_in_month, is_rented, income_payment_type, etc.) are case-sensitive.
  • Passing unlisted values (for example: family for reference_relationship1) will result in errors. Likewise, do not pass empty fields; instead omit the fields.
  • Out-of-range or logically impossible values, like stay_in_month=100, or stay_in_year=100 when dob=1980, will fail.
  • Remember to set lead_mode=1 when you go live!

Back to contents




Testing

For testing, i.e. when lead_mode=0, please attempt at least three different leads, each with a different zip code. One should end with and even number, one should end with an odd number, and one should end with a 0 (zero). The responses generated will vary based on the zip code used, as follows:

  • If you PING a test lead with a zip code that ends with a ZERO (e.g. 19460), you will receive the 'No Coverage' response, i.e. it will be REJECTED on the PING.
  • If you PING a test lead with a zip code that ends with an ODD number (e.g. 19461), you will receive a bid, i.e. it will be ACCEPTED on the PING. When you POST that same lead to us, it will be REJECTED on the POST.
  • If you PING a test lead with a zip code that ends with an EVEN number (e.g. 19462), you will receive a bid. When you POST that same lead to us, it will be ACCEPTED on the POST.

Please email all of the ping and post requests AND their corresponding responses to tech@astoriacompany.com so that we can verify the tests and activate your account.

Testing via a Third Party Service

If you are having issues getting the response you expect, please use hurl.it or a similar service to hit our API with the following settings (refer to this image):

  1. Go to: hurl.it
  2. Select 'POST' in the first dropdown
  3. For the URL, enter: https://api.astoriacompany.com/v2/ping/ (or https://api.astoriacompany.com/v2/post/ if testing a post)
  4. Add a Header: 'Content-Type' with a value of 'application/x-www-form-urlencoded'
  5. Paste your ping or post request into the 'Parameters' text area
  6. Click: Launch Request

Back to contents




Parameter Values

Field Contents Values Allowed Required?
driverX_education Education Level 1 => Less than High School
2 => Some or No High School
3 => High School Diploma
4 => Some College
5 => Associate Degree
6 => Bachelors Degree
7 => Masters Degree
8 => Doctorate Degree
9 => Other
Required
Field Contents Values Allowed Required?
driverX_occupation Driver Occupation 1 => Accounts Pay/Rec.
2 => Actor
3 => Administration/Management
4 => Appraiser
5 => Architect
6 => Artist
7 => Assembler
8 => Auditor
9 => Baker
10 => Bank Teller
11 => Banker
12 => Bartender
13 => Broker
14 => Cashier
15 => Casino Worker
16 => CEO
17 => Certified Public Accountant
18 => Chemist
19 => Child Care
20 => City Worker
21 => Claims Adjuster
22 => Clergy
23 => Clerical/Technical
24 => College Professor
25 => Computer Tech
26 => Construction
27 => Contractor
28 => Counselor
29 => Craftsman/Skilled Worker
30 => Customer Support Rep
31 => Custodian
32 => Dancer
33 => Decorator
34 => Delivery Driver
35 => Dentist
36 => Director
37 => Disabled
38 => Drivers
39 => Electrician
40 => Engineer-Aeronautical
41 => Engineer-Aerospace
42 => Engineer-Chemical
43 => Engineer-Civil
44 => Engineer-Electrical
45 => Engineer-Gas
46 => Engineer-Geophysical
47 => Engineer-Mechanical
48 => Engineer-Nuclear
49 => Engineer-Other
50 => Engineer-Petroleum
51 => Engineer-Structural
52 => Entertainer
53 => Farmer
54 => Fire Fighter
55 => Flight Attend.
56 => Food Service
57 => Health Care
58 => Installer
59 => Instructor
60 => Journalist
61 => Journeyman
62 => LabTech.
63 => Laborer/Unskilled Worker
64 => Lawyer
65 => Machine Operator
66 => Machinist
67 => Maintenance
68 => Manufacturer
69 => Marketing
70 => Mechanic
71 => Model
72 => Nanny
73 => Nurse/CNA
74 => Other
75 => Painter
76 => Para-Legal
77 => Paramedic
78 => Personal Trainer
79 => Photographer
80 => Physician
81 => Pilot
82 => Plumber
83 => Police Officer
84 => Postal Worker
85 => Preacher
86 => Pro Athlete
87 => Production
88 => Prof-College Degree
89 => Prof-Specialty Degree
90 => Programmer
91 => Real Estate
92 => Receptionist
93 => Reservation Agent
94 => Restaurant Manager
95 => Retail
96 => Roofer
97 => Sales
98 => Scientist
99 => Secretary
100 => Security
101 => Social Worker
102 => Stocker
103 => Store Owner
104 => Stylist
105 => Supervisor
106 => Teacher
107 => Teacher - with Credentials
108 => Technical/Supervisory
109 => Travel Agent
110 => Truck Driver
111 => Vet
112 => Waitress
113 => Welder
114 => Government
115 => Housewife/Househusband
116 => Retired
117 => Student Not Living w/Parents
118 => Unemployed
119 => Military E1 - E4
120 => Military E5 - E7
121 => Military Officer
122 => Military Other
123 => Unknown
124 => Self Employed
125 => Student Living w/Parents
Required
Field Contents Values Allowed Required?
driverX_ticketYDescription Driver Ticket Description 1 => Careless driving
2 => Carpool lane violation
3 => Child not in car seat
4 => Defective Equipment
5 => Defective vehicle (reduced violation)
6 => Driving too fast for conditions
7 => Driving without a license
8 => Excessive noise
9 => Exhibition driving
10 => Expired drivers license
11 => Expired emmissions
12 => Expired Registration
13 => Failure to obey traffic signal
14 => Failure to signal
15 => Failure to stop
16 => Failure to yield
17 => Following too close
18 => Illegal lane change
19 => Illegal passing
20 => Illegal turn
21 => Illegal turn on red
22 => Illegal U Turn
23 => Inattentive driving
24 => No helmet
25 => No insurance
26 => No seatbelt
27 => Passing a school bus
28 => Passing in a no-passing zone
29 => Passing on shoulder
30 => Ran a red light
31 => Ran a stop sign
32 => Wrong way on a one way
33 => Speeding
34 => Speeding less than 10 MPH over
35 => Speeding more than 10 MPH over
36 => Speeding more than 20 MPH over
37 => Other Ticket
Required
Field Contents Values Allowed Required?
driverX_accidentYDescription Driver Accident Description 1 => Vehicle Hit Vehicle
2 => Vehicle Hit Pedestrian
3 => Vehicle Hit Property
4 => Vehicle Damaged Avoiding Accident
5 => Other Vehicle Hit Yours
6 => Not Listed
Required
Field Contents Values Allowed Required?
driverX_violationYDescription Driver Violation Description 1 => Driving While Suspended/Revoked
2 => Drunk Driving - Injury
3 => Drunk Driving - no Injury
4 => Hit and Run - Injury
5 => Hit and Run - no Injury
6 => Reckless Driving - Injury
7 => Reckless Driving - no Injury
8 => Speeding Over 100
Required
Field Contents Values Allowed Required?
driverX_claimYDescription Driver Claim Description 1 => Act of Nature
2 => Car fire
3 => Flood damage
4 => Hail damage
5 => Hit an animal
6 => Theft of stereo
7 => Theft of vehicle
8 => Towing service
9 => Vandalism
10 => Windshield Replacement
11 => Other
Required
Field Contents Values Allowed Required?
insuranceCompany 1 => Company Not Listed
2 => 21st Century Insurance
3 => AAA Insurance Co.
4 => AARP
5 => AETNA
6 => AFLAC
7 => AIG
8 => AIU Insurance
9 => Allied
10 => Allstate County Mutual
11 => Allstate Indemnity
12 => Allstate Insurance
13 => American Alliance Insurance
14 => American Automobile Insurance
15 => American Casualty
16 => American Deposit Insurance
17 => American Direct Business Insurance
18 => American Empire Insurance
19 => American Family Insurance
20 => American Family Mutual
21 => American Financial
22 => American Health Underwriters
23 => American Home Assurance
24 => American Insurance
25 => American International Ins
26 => American International Pacific
27 => American International South
28 => American Manufacturers
29 => American Mayflower Insurance
30 => American Motorists Insurance
31 => American National Insurance
32 => American Premier Insurance
33 => American Protection Insurance
34 => American Republic
35 => American Savers Plan
36 => American Service Insurance
37 => American Skyline Insurance Company
38 => American Spirit Insurance
39 => American Standard Insurance - OH
40 => American Standard Insurance - WI
41 => AmeriPlan
42 => Amica Insurance
43 => Answer Financial
44 => Arbella
45 => Associated Indemnity
46 => Assurant
47 => Atlanta Casualty
48 => Atlantic Indemnity
49 => Auto Club Insurance Company
50 => AXA Advisors
51 => Bankers Life and Casualty
52 => Banner Life
53 => Best Agency USA
54 => Blue Cross and Blue Shield
55 => Brooke Insurance
56 => Cal Farm Insurance
57 => California State Automobile Association
58 => Chubb
59 => Citizens
60 => Clarendon American Insurance
61 => Clarendon National Insurance
62 => CNA
63 => Colonial Insurance
64 => Comparison Market
65 => Continental Casualty
66 => Continental Divide Insurance
67 => Continental Insurance
68 => Cotton States Insurance
69 => Country Insurance and Financial Services
70 => Countrywide Insurance
71 => CSE Insurance Group
72 => Dairyland County Mutual Co of TX
73 => Dairyland Insurance
74 => eHealthInsurance Services
75 => Electric Insurance
76 => Erie Insurance Company
77 => Erie Insurance Exchange
78 => Erie Insurance Group
79 => Erie Insurance Property and Casualty
80 => Esurance
81 => Farm Bureau/Farm Family/Rural
82 => Farmers Insurance
83 => Farmers Insurance Exchange
84 => Farmers TX County Mutual
85 => Farmers Union
86 => FinanceBox.com
87 => Fire and Casualty Insurance Co of CT
88 => Fireman's Fund
89 => Foremost
90 => Foresters
91 => Geico Casualty
92 => Geico General Insurance
93 => Geico Indemnity
94 => GMAC Insurance
95 => Golden Rule Insurance
96 => Government Employees Insurance
97 => Guaranty National Insurance
98 => Guide One Insurance
99 => Hanover Lloyd's Insurance Company
100 => Hartford Accident and Indemnity
101 => Hartford Casualty Insurance
102 => Hartford Fire Insurance
103 => Hartford Insurance Co of Illinois
104 => Hartford Insurance Co of the Southeast
105 => Hartford Omni
106 => Hartford Underwriters Insurance
107 => Health Benefits Direct
108 => Health Choice One
109 => Health Plus of America
110 => HealthShare American
111 => Humana
112 => IFA Auto Insurance
113 => IGF Insurance
114 => Infinity Insurance
115 => Infinity National Insurance
116 => Infinity Select Insurance
117 => Insurance Insight
118 => Insurance.com
119 => InsuranceLeads.com
120 => InsWeb
121 => Integon
122 => John Hancock
123 => Kaiser Permanente
124 => Kemper Lloyds Insurance
125 => Landmark American Insurance
126 => Leader National Insurance
127 => Leader Preferred Insurance
128 => Leader Specialty Insurance
129 => Liberty Insurance Corp
130 => Liberty Mutual Fire Insurance
131 => Liberty Mutual Insurance
132 => Liberty National
133 => Liberty Northwest Insurance
134 => Lumbermens Mutual
135 => Maryland Casualty
136 => Mass Mutual
137 => Mega/Midwest
138 => Mercury
139 => MetLife Auto and Home
140 => Metropolitan Insurance Co.
141 => Mid Century Insurance
142 => Mid-Continent Casualty
143 => Middlesex Insurance
144 => Midland National Life
145 => Mutual of New York
146 => Mutual Of Omaha
147 => National Ben Franklin Insurance
148 => National Casualty
149 => National Continental Insurance
150 => National Fire Insurance Company of Hartford
151 => National Health Insurance
152 => National Indemnity
153 => National Union Fire Insurance of LA
154 => National Union Fire Insurance of PA
155 => Nationwide General Insurance
156 => Nationwide Insurance Company
157 => Nationwide Mutual Fire Insurance
158 => Nationwide Mutual Insurance
159 => Nationwide Property and Casualty
160 => New England Financial
161 => New York Life Insurance
162 => Northwestern Mutual Life
163 => Northwestern Pacific Indemnity
164 => Omni Indemnity
165 => Omni Insurance
166 => Orion Insurance
167 => Pacific Indemnity
168 => Pacific Insurance
169 => Pafco General Insurance
170 => Patriot General Insurance
171 => Peak Property and Casualty Insurance
172 => PEMCO Insurance
173 => Physicians
174 => Progressive
175 => Progressive Auto Pro
176 => Prudential Insurance Co.
177 => Reliance Insurance
178 => Reliance National Indemnity
179 => Reliance National Insurance
180 => Republic Indemnity
181 => Response Insurance
182 => SAFECO
183 => Safeway Insurance
184 => Safeway Insurance Co of AL
185 => Safeway Insurance Co of GA
186 => Safeway Insurance Co of LA
187 => Security Insurance Co of Hartford
188 => Security National Insurance Co of FL
189 => Sentinel Insurance
190 => Sentry Insurance a Mutual Company
191 => Sentry Insurance Group
192 => Shelter Insurance Co.
193 => St. Paul
194 => St. Paul Fire and Marine
195 => St. Paul Insurance
196 => Standard Fire Insurance Company
197 => State and County Mutual Fire Insurance
198 => State Farm County
199 => State Farm Fire and Cas
200 => State Farm General
201 => State Farm Indemnity
202 => State Farm Insurance Co.
203 => State Farm Lloyds Tx
204 => State Farm Mutual Auto
205 => State Fund
206 => State National Insurance
207 => Superior American Insurance
208 => Superior Guaranty Insurance
209 => Superior Insurance
210 => Sure Health Plans
211 => The Ahbe Group
212 => The General
213 => The Hartford
214 => TICO Insurance
215 => TIG Countrywide Insurance
216 => Titan
217 => TransAmerica
218 => Travelers Indemnity
219 => Travelers Insurance Company
220 => Tri-State Consumer Insurance
221 => Twin City Fire Insurance
222 => UniCare
223 => United American/Farm and Ranch
224 => United Pacific Insurance
225 => United Security
226 => United Services Automobile Association
227 => Unitrin Direct
228 => Universal Underwriters Insurance
229 => US Financial
230 => USA Benefits/Continental General
231 => USAA
232 => USF and G
233 => Viking County Mutual Insurance
234 => Viking Insurance Co of WI
235 => Western and Southern Life
236 => Western Mutual
237 => Windsor Insurance
238 => Woodlands Financial Group
239 => Zurich North America
Required