EIN Lookup

overview the ein lookup api facilitates the retrieval of detailed company information through searches by ein (employer identification number) or business name this service is designed to provide a quick and accurate verification of company identities and their corresponding tax information as registered in the irs database ein stands for employer identification number it is a unique nine digit number assigned by the internal revenue service (irs) to businesses, non profits, and other entities for tax identification purposes in the united states an ein is similar to a social security number for individuals it is used by the irs to identify businesses and organizations for tax reporting and filing requirements the ein is required for various activities, including opening a business bank account, hiring employees, filing tax returns, and conducting certain financial transactions the ein lookup api provides a robust mechanism for getting information related to companies against company names and other eins it is designed to facilitate the confirmation of company identities for financial, legal, and compliance purposes use cases financial compliance utilized by financial institutions to verify company details during account openings or loan processing business verification employed by companies to ensure the authenticity of business partners or vendors before engaging in contracts and agreements regulatory compliance used by compliance officers to validate and ensure that businesses meet regulatory requirements for taxation and business operations api details request body curl location 'https //api preproduction signzy us/api/v3/us apis/company/einlookup' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "searchmethod" "einnumber/name", "searchvalue" "201636974", "statecode" "us fl", "zip" "32746", "strictsearch" "true" }'curl location 'https //api signzy us/api/v3/us apis/company/einlookup' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "searchmethod" "einnumber/name", "searchvalue" "201636974", "statecode" "us fl", "zip" "32746", "strictsearch" "true" }' request body mapping parameter type description required searchmethod string method of search, either einnumber or name yes searchvalue string the ein or business name to search yes statecode string state code where the business is registered optional zip string zip code of the business location optional strictsearch string whether to enforce a strict search matching the exact details optional response body 200 success { "result" { "searchmethod" "einnumber", "searchvalue" "201636974", "einsearchoptions" { "statecode" "us fl", "zip" "32746", "strictsearch" "true" }, "searchresults" \[ { "name" "capjr llc", "ein" "201636974", "irsscore" "a", "irsscoreexplanation" "100% match between name and ein in the irs database ", "dbascore" "no", "dbascoreexplanation" "company name is a legal name for the business and not dba", "companyscore" 100, "companyscoreexplanation" "this record appears 100% of times under the associated ein", "providedstatus" "a", "providedstatusexplanation" "address has been verified and is ncoa plus 4", "confidencescore" "a", "confidencescoreexplanation" "this record appears 100% of times under the associated ein", "address" \[ "190 n country club rd", "32746", "lake mary", "fl", "us" ], "formattedaddress" { "street" "190 n country club rd", "zip" "32746", "state" "fl", "city" "lake mary", "country" "us" } } ], "source" { "name" "ein finder", "info" "", "primary" "true" } } } { "result" { "searchmethod" "einnumber", "searchvalue" "821104267", "einsearchoptions" { "statecode" "us az", "zip" "85086", "strictsearch" "true" }, "searchresults" \[], "source" { "name" "ein finder", "info" "", "primary" "true" } } } api output mapping true false 253false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type sample error wrong statecode format 400 { "error" { "name" "error", "message" "\\"statecode\\" must be one of the valid us state codes (us xx format)", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } companyname not passed 400 { "error" { "name" "error", "message" "bad request \\"searchvalue\\" can include only 9 digits when \\"searchmethod\\" is 'einnumber' ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } upstream error 409 { "error" { "name" "error", "message" "error in getting data from upstream", "status" 409, "reason" "error", "type" "conflict", "statuscode" 409 } } internal server error 500 { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "conflict", "statuscode" 500 } } error response parameters 283,520 false true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type left unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at help\@signzy com we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!