Global Business Advanced - Search Entity by Name

overview & purpose this api enables users to search for business entities based on various criteria such as country, state, entity name, entity status, incorporation date, and inactive flag upon making a request, the api returns a list of matching companies that meet the specified criteria each company in the list is accompanied by comprehensive information, including its name, business id, country, state, company type, address details, status, incorporation date, dissolution date, registry url, and more this api is useful for conducting searches and retrieving detailed information about business entities for various purposes such as due diligence, compliance checks, and business research api details production curl location 'https //api signzy app/api/v3/global business advanced name' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "entityname" "gateway consulting group", "country" "us", "state" "ca" }' pre production curl location 'https //api preproduction signzy app/api/v3/global business advanced name' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "entityname" "gateway consulting group", "country" "us", "state" "ca" }' input parameters parameters description type value (compulsory or optional) entityname name of the company to be searched string compulsory country country code of the country string optional state state code of the company string conditional entitystatus status of the company string optional incorporationdate incorporationdate of the company string optional inactiveflag inactive status of the company string optional the supported country codes are listed below country code country name ae united arab emirates al albania au australia aw aruba bb barbados bd bangladesh be belgium bg bulgaria bh bahrain bl saint barthélemy bm bermuda bo bolivia br brazil bs bahamas by belarus bz belize ca canada ch switzerland cw curacao cy cyprus cz czech republic de germany dk denmark do dominican republic es spain fi finland fr france fr réunion gb united kingdom gf french guiana gg guernsey gi gibraltar gl greenland gp guadeloupe gr greece hk hong kong hr croatia ie ireland il israel im isle of man in india ir iran is iceland je jersey jm jamaica jp japan kh cambodia li liechtenstein lu luxembourg lv latvia md moldova me montenegro mf saint martin mm myanmar mq martinique mt malta mu mauritius mx mexico my malaysia nl netherlands no norway nz new zealand pa panama pk pakistan pl poland pm saint pierre and miquelon pr puerto rico pt portugal ro romania rw rwanda se sweden sg singapore si slovenia sk slovakia th thailand tj tajikistan tn tunisia to tonga tz tanzania ua ukraine ug uganda us united states of america vn viet nam vu vanuatu yt mayotte za south africa the supported state codes for us are listed below state code state name ak alaska al alabama ar arkansas az arizona ca california co colorado ct connecticut dc district of columbia de delaware fl florida ga georgia hi hawaii ia iowa id idaho in indiana ks kansas ky kentucky la louisiana ma massachusetts md maryland me maine mn minnesota mo missouri ms mississippi mt montana nc north carolina nd north dakota ne nebraska nh new hampshire nj new jersey nm new mexico nv nevada ny new york oh ohio ok oklahoma or oregon pa pennsylvania ri rhode island sc south carolina sd south dakota tn tennessee tx texas ut utah va virginia vt vermont wa washington wi wisconsin wv west virginia wy wyoming the supported state codes for ca are listed below state code province bc british columbia nb new brunswick nl newfoundland and labrador ns nova scotia on ontario pe prince edward island qc quebec the supported state codes for ae are listed below state code state name az abu dhabi (uae) du dubai (uae) the supported state codes for fr are listed below state code state name re reunion output parameters success response & mapping { "result" { "companies" \[ { "company" { "companyname" " companyname ", "businessid" " businessid ", "country" " country ", "state" " state ", "companytype" " companytype ", "companyaddressdetails" " companyaddressdetails ", "companyaddress" { "companystreetaddress" " companystreetaddress ", "companylocality" " companylocality ", "companyregion" " companyregion ", "companypostalcode" " companypostalcode ", "companycountry" " companycountry " }, "incorporationdate" " incorporationdate ", "currentcompanystatus" " currentcompanystatus ", "isinactive" " isinactive ", "dissolutiondate" " dissolutiondate ", "registryurl" " registryurl ", "updatedat" " updatedat ", "isbranch" " isbranch ", "branchstatus" " branchstatus ", "previousnames" \[ { "companypreviousname" " companypreviousname ", "startdate" " startdate ", "enddate" " enddate " } ], "source" " source ", "sourceurl" " sourceurl ", "industrycodes" \[ { "industrycodedescription" " industrycodedescription ", "industrycodeschemeid" " industrycodeschemeid ", "industrycodescheme" " industrycodescheme " } ] } } ] } } output parameter field name data type description result object the root object containing all information companies array an array of company objects company object information about a company companyname string the name of the company businessid string the business id of the company country string the country where the company is located state string the state or region where the company is located companytype string the type or category of the company companyaddressdetails string additional details about the company address companyaddress object address information for the company companystreetaddress string the street address of the company companylocality string the locality or city where the company is located companyregion string the region or state where the company is located companypostalcode string the postal code of the company's location companycountry string the country where the company is located incorporationdate string the date of incorporation of the company currentcompanystatus string the current status of the company isinactive string indicates whether the company is inactive dissolutiondate string the date of dissolution of the company registryurl string url to the company's registry information updatedat string the date when the information was last updated isbranch string indicates whether the company is a branch branchstatus string the status of the company branch previousnames array an array of objects containing information about previous company names companypreviousname string the previous name of the company startdate string the start date of the previous company name enddate string the end date of the previous company name source string the source of the company information sourceurl string url to the source of the company information industrycodes array an array of objects containing industry code information industrycodedescription string description of the industry code industrycodeschemeid string the id of the industry code scheme industrycodescheme string the name or scheme of the industry code error code response & mapping { "error" { "statuscode" 409, "name" "error", "message" "error in getting data from upstream", "status" 409 } } field name data type description error object the root object containing error details statuscode number the http status code indicating the error (409) name string the name or type of the error ("error") message string a descriptive error message explaining the issue ("error in getting data from upstream") status number an additional status code providing more information about the error (409) 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!