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 field type description result object container for all the api response details searchmethod string method used for searching the ein details searchvalue string ein or business name used in the search query einsearchoptions object options used in the ein search query including state code, zip, and strict search settings statecode string state code where the business is registered zip string zip code of the business location strictsearch boolean whether the search was performed with strict criteria searchresults array list of results matching the search criteria each item in the array is detailed below name string name of the business entity found ein string employer identification number of the business irsscore string score indicating the irs match quality irsscoreexplanation string explanation of the irs score dbascore string score indicating if the business name is a dba dbascoreexplanation string explanation of the dba score companyscore integer numerical score representing the frequency of record appearance under the ein companyscoreexplanation string explanation of the company score providedstatus string status provided after verifying the business address providedstatusexplanation string explanation of the provided status confidencescore string overall confidence score of the record confidencescoreexplanation string explanation behind the confidence score address array address details as a simple list (not structured) formattedaddress object structured address details street string street part of the address zip string postal zip code part of the address state string state part of the address city string city part of the address country string country part of the address source object data source information name string name of the source (e g , "ein finder") info string additional information about the source, if any primary boolean indicates if this is the primary source of data 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 parameter description error this parameter contains the error error name the error name error message the error message error status s tatus of the api error reason reason for error error type type of the error error statuscode request status code from signzy 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!