Data Format

If data is being provided in a batch feed, the format of the file should be an ASCII text file with comma delimiters in the order specified below. Realtime integration should follow the appropriate API specification.

Input Fields

FieldDescriptionField TypeData Type
customer_idUnique customer identifierRequiredstring
customer_id2Secondary unique customer identifierOptionalstring
api_versionCurrent production version of APIRequiredstring
customer_request_idUnique customer supplied request ID numberRequiredstring
(10 digit max)
first_nameFirst nameRequiredstring
last_nameLast nameRequiredstring
street_addrStreet addressRequiredstring
cityCity portion of addressRequiredstring
stateState portion of addressRequiredstring
zipZip portion of addressRequiredstring
ssnSocial Security NumberRequiredstring
dobDate of BirthOptionalint
(YYYYMMDD)
phonePhone numberRequiredint
(10 digit)
emp_nameEmployer nameOptionalstring
emp_phoneEmployer phone numberOptionalint
(10 digit)
income_annualAnnual incomeOptionalint
occupationOccupationOptionalstring
emailEmail addressOptionalstring
user_defined_field1User defined field 1Optionalstring
user_defined_field2User defined field 2Optionalstring
user_defined_field3User defined field 3Optionalstring
user_defined_field4User defined field 4Optionalstring
user_defined_field5User defined field 5Optionalstring
user_defined_field6User defined field 6Optionalstring
rooftop_idRooftop number in case customer has multiple rooftopsRequiredstring

Sample Input

{
    "customer_id": "123456789",
    "customer_id2": null,
    "api_version": "1.00",
    "customer_request_id": "123456789",
    "first_name": "FIRST NAME",
    "last_name": "LAST NAME",
    "street_addr": "XXX STREET NAME",
    "city": "CITY",
    "state": "STATE", // 2 letter
    "zip": "ZIPCODE", // 5 digit
    "ssn": "XXXXXXXXX",
    "dob": "YYYYMMDD",
    "phone": "XXXXXXXXXX", // 10 digit
    "emp_name": "EMPLOYER NAME",
    "emp_phone": "XXXXXXXXX",
    "income_annual": "XXXXX",
    "occupation": "OCCUPATION",
    "email": "[email protected]",
    "user_defined_field1": null,
    "user_defined_field2": null,
    "user_defined_field3": null,
    "user_defined_field4": null,
    "user_defined_field5": null,
    "user_defined_field6": null,
  	"rooftop_id": "ROOFTOP ID"
}