THE AMERICAS
United States of America
United States Credit Bureau
4 min
verifies input data against credit header data obtained from the partnered sources from united states of america for authorization get session token from authentication page { "name" "united states credit bureau", "method" "post", "url" "https //idu test datazoo com/api/v2/verify", "description" " verification outcome – returns kyc verification\n consumer consent – n/a\n mandatory input – name and two other input fields at a minimum\n verifies – name, dob, address, phone number, email address and social security number\n returned data alternative dob matching logic indicator (if configured for usa)", "tab" "examples", "examples" { "languages" \[ { "id" "f2jmy98siubrop0bgc788", "language" "curl", "code" "curl location 'https //idu test datazoo com/api/v2/verify' \\\\\n header 'content type application/json' \\\\\n header 'authorization bearer eyjhbgcioijsuzi1niisinr5cci6ikpxvcisimtpzci6immtbvzlml9krfhmcnkzaehqwen4tyj9 eyj1awqioiizmdmilcjvawqioii2miisimlzcyi6imh0dhbzoi8vzgf0yxpvby10zxn0lnvzlmf1dggwlmnvbs8ilcjzdwiioijhdxromhwzmdmilcjhdwqioijodhrwczovl2t5yy10zxn0lmrhdgf6b28uy29tiiwiawf0ijoxnzq3njk1mza5lcjlehaioje3ndc3mzezmdksimd0esi6inbhc3n3b3jkiiwiyxpwijoiswxvdurjntf1qxpuvne2vgvorxayoxbrbehbsjftynkifq aiarl04ab5moi2afn8oxb31s eur2wdu2haoov7doq3r2xvamgc2g8edb8glyz6x jbg o cgqdchsb05lolfhps2b9gk7z slyy2azspejry7kphqelbok rshalthjpghtpa jynafm5u3tsbusiar wz6ueskdyyghu1si 0yfrpcpjd1ulfwqy6ugklztdejlrwrpadodbp0lxrckmtenrjlx ye2bofwfwwwn1rbbzmyzga4qfkbfm8wkgrclyhtzc2pioblgzi7aws0woyskn9o6bscnznov1pz9zr3itobl4o agiofch6bsbok8wch1n4cbevhzy7eoora' \\\\\n data raw '{\n\t\\"countrycode\\" \\"us\\",\n\t\\"service\\" \[\n\t\t\\"united states credit bureau\\"\n\t],\n\t\\"clientreference\\" \\"test 0001\\",\n\t\\"firstname\\" \\"michael\\", \n\t\\"middlename\\" \\"\\", \n\t\\"lastname\\" \\"scudero\\", \n\t\\"dateofbirth\\" \\"1989 06 21\\", \n\t\\"addresselement1\\" \\"66 bethany road\\", \n\t\\"addresselement3\\" \\"holmdel\\", \n\t\\"addresselement4\\" \\"nj\\", \n\t\\"addresselement5\\" \\"07733\\", \n\t\\"identityvariables\\" { \n\t\t\\"socialsecurityno\\" null, \n\t\t\\"phoneno\\" \\"7327680712\\", \n\t\t\\"email\\" \\"hoymike794\@gmail com\\" \n\t}\n}'", "customlabel" "" } ], "selectedlanguageid" "f2jmy98siubrop0bgc788" }, "results" { "languages" \[ { "id" " kllvb jxqiuu wuwqaf", "language" "200", "customlabel" "", "code" "{\n \\"countrycode\\" \\"united states\\",\n \\"clientreference\\" \\"test 0001\\",\n \\"reportingreference\\" \\"dz df5ef3a5 93dc 44c0 bc76 fe014b2778ab\\",\n \\"matchstatus\\" \\"full match 1+1 verification\\",\n \\"searcherrormessage\\" \\"\\",\n \\"safeharbour\\" false,\n \\"searchstatus\\" \\"successful\\",\n \\"serviceresponses\\" {\n \\"united states credit bureau\\" {\n \\"status\\" 0,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"m1\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"1 000\\",\n \\"verifications\\" {\n \\"addresselement1\\" true,\n \\"addresselement3\\" true,\n \\"addresselement4\\" true,\n \\"addresselement5\\" true,\n \\"dateofbirth\\" true,\n \\"email\\" true,\n \\"firstname\\" true,\n \\"lastname\\" true,\n \\"phoneno\\" true\n },\n \\"returneddata\\" {}\n }\n },\n \\"remarks\\" \[]\n}" }, { "id" "as5tj4glqvhlg7b69q21j", "language" "404", "customlabel" "", "code" "{\n \\"message\\" \\"ain't no cake like that \\"\n}" } ], "selectedlanguageid" " kllvb jxqiuu wuwqaf" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[ { "name" "authorization", "kind" "required", "type" "string", "description" "sessiontoken obtained via the authentication call", "" "sessiontoken obtained via the authentication call" } ], "bodydataparameters" \[ { "name" "data", "kind" "required", "type" "object", "description" "request body sent to the api", "" "object", "children" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "us" }, { "name" "service", "kind" "required", "type" "array", "description" "united states credit bureau" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "firstname", "kind" "required", "type" "string", "description" "the first name of the identity owner" }, { "name" "middlename", "kind" "optional", "type" "string", "description" "the middle name(s) of the identity owner" }, { "name" "lastname", "kind" "required", "type" "string", "description" "the last name of the identity owner", "children" \[] }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement1", "kind" "required", "type" "string", "description" "the street level address of the identity owner\n \[conditional optional see note below]" }, { "name" "addresselement3", "kind" "required", "type" "string", "description" "the town/city of the address of the identity owner\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement4", "kind" "required", "type" "string", "description" "the state name of the address of the identity owner\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement5", "kind" "required", "type" "string", "description" "the zip code of the address of the identity owner\n \[conditional optional see note below]" }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "phoneno", "kind" "required", "type" "string", "description" "phone number of the identity owner\n \[conditional optional see note below]" }, { "name" "socialsecurityno", "kind" "required", "type" "string", "description" "social security number of the identity owner\n \[conditional optional see note below]" }, { "name" "email", "kind" "required", "type" "string", "description" "email address of the identity owner\n \[conditional optional see note below]" } ] } ], "schema" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "us" }, { "name" "service", "kind" "required", "type" "array", "description" "united states credit bureau" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "firstname", "kind" "required", "type" "string", "description" "the first name of the identity owner" }, { "name" "middlename", "kind" "optional", "type" "string", "description" "the middle name(s) of the identity owner" }, { "name" "lastname", "kind" "required", "type" "string", "description" "the last name of the identity owner", "children" \[] }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement1", "kind" "required", "type" "string", "description" "the street level address of the identity owner\n \[conditional optional see note below]" }, { "name" "addresselement3", "kind" "required", "type" "string", "description" "the town/city of the address of the identity owner\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement4", "kind" "required", "type" "string", "description" "the state name of the address of the identity owner\n \[conditional optional see note below]", "children" \[] }, { "name" "addresselement5", "kind" "required", "type" "string", "description" "the zip code of the address of the identity owner\n \[conditional optional see note below]" }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "phoneno", "kind" "required", "type" "string", "description" "phone number of the identity owner\n \[conditional optional see note below]" }, { "name" "socialsecurityno", "kind" "required", "type" "string", "description" "social security number of the identity owner\n \[conditional optional see note below]" }, { "name" "email", "kind" "required", "type" "string", "description" "email address of the identity owner\n \[conditional optional see note below]" } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "countrycode", "kind" "optional", "type" "string", "description" "united states", "children" \[] }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "the client reference (if given as input) ", "children" \[] }, { "name" "reportingreference", "kind" "optional", "type" "string", "description" "a reference number generated which is unique to each transaction ", "children" \[] }, { "name" "validationerrors", "kind" "optional", "type" "string", "description" "returned with http status code 400 when the request contains invalid or improperly formatted input data ", "children" \[] }, { "name" "matchstatus", "kind" "optional", "type" "string", "description" "\\"full match 1+1 verification\\" \n\\"no match\\" " }, { "name" "searcherrormessage", "kind" "optional", "type" "string", "description" "error message returned querying the data source", "children" \[] }, { "name" "safeharbour", "kind" "optional", "type" "boolean", "description" "true or false", "children" \[] }, { "name" "searchstatus", "kind" "optional", "type" "string", "description" "\\"successful\\" \n\\"not successful\\"", "children" \[] }, { "name" "serviceresponses", "kind" "optional", "type" "object", "description" "verification details with \\"united states credit bureau\\" returned as the service identifier ", "children" \[ { "name" "status", "kind" "optional", "type" "integer", "description" "0 identityverified true element verifications all true\n1 identityverified true element verifications not all true\n2 identityverified false sourcestatus successful\n3 identityverified false sourcestatus not successful" }, { "name" "sourcestatus", "kind" "optional", "type" "string", "description" "\\"successful\\"\n\\"not successful\\"" }, { "name" "errormessage", "kind" "optional", "type" "string", "description" "error message(s) from the data source example, \\"error querying data source\\" " }, { "name" "identityverified", "kind" "optional", "type" "boolean", "description" "true or false" }, { "name" "safeharbourscore", "kind" "optional", "type" "string", "description" "m1, m2, n1, l1, l2, l3, l4, c1, c2, c3, c4, c5, p1, p2, p5 or \\"none\\"\n for more information, refer to safe harbour scores page" }, { "name" "namematchscore", "kind" "optional", "type" "string", "description" "a string that acts as a value between 0 000 and 1 000 " }, { "name" "addressmatchscore", "kind" "optional", "type" "string", "description" "a string that acts as a value between 0 000 and 1 000 " }, { "name" "verifications", "kind" "optional", "type" "object", "description" "element level verification returned as true or false\n\[only applicable elements will be included, and not all elements may be present]", "children" \[ { "name" "addresselement1", "kind" "optional", "type" "boolean", "description" "" }, { "name" "addresselement3", "kind" "optional", "type" "boolean", "description" "" }, { "name" "addresselement4", "kind" "optional", "type" "boolean", "description" "" }, { "name" "addresselement5", "kind" "optional", "type" "boolean", "description" "" }, { "name" "dateofbirth", "kind" "optional", "type" "boolean", "description" "" }, { "name" "email", "kind" "optional", "type" "boolean", "description" "" }, { "name" "firstname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "lastname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "middlename", "kind" "optional", "type" "boolean", "description" "" }, { "name" "phoneno", "kind" "optional", "type" "boolean", "description" "" }, { "name" "socialsecurityno", "kind" "optional", "type" "boolean", "description" "" } ] }, { "name" "returneddata", "kind" "optional", "type" "object", "description" "returns additional data from the data source ", "children" \[ { "name" "altdobscore", "kind" "optional", "type" "string", "description" "dob matching logic indicator (if configured)" } ] } ] }, { "name" "remarks", "kind" "optional", "type" "array", "description" "will return remarks regarding any encountered issues or pre validation errors ", "children" \[] } ] } mandatory input including name the api request must contain firstname and lastname and two other fields at a minimum from below as input dateofbirth , addresselement1 , addresselement3 , addresselement4 , addresselement5 , socialsecurityno , phoneno and email links