Global Business Advanced - Search Entity by ID

overview & purpose this api allows users to retrieve detailed information about a company or business entity by providing essential details such as country, state, and entity id, users can obtain comprehensive data including the company's name, address, status, financial summary, officers, filings, industry codes, and more this information can be valuable for various business and regulatory purposes api details production curl location 'https //api signzy app/api/v3/global business advanced id' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "entityid" "3582691", "country" "us", "state" "ca" }' pre production curl location 'https //api preproduction signzy app/api/v3/global business advanced id' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data '{ "entityid" "3582691", "country" "us", "state" "ca" }' api input input parameters parameters description type value (compulsory or optional) entityid business number of the company to be searched string compulsory country country code of the country string compulsory state state code of the company string conditional 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 state name nb new brunswick nl newfoundland and labrador ns nova scotia 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 api output sucess response & mapping { "result" { "company" { "companyname" " companyname ", "businessid" " businessid ", "country" " country ", "state" " state ", "companyaddressdetails" " companyaddressdetails ", "companyaddress" { "companystreetaddress" " companystreetaddress ", "companylocality" " companylocality ", "companyregion" " companyregion ", "companypostalcode" " companypostalcode ", "companycountry" " companycountry " }, "currentcompanystatus" " currentcompanystatus ", "incorporationdate" " incorporationdate ", "isinactive" " isinactive ", "dissolutiondate" " dissolutiondate ", "companytype" " companytype ", "registryurl" " registryurl ", "numberofemployees" " numberofemployees ", "previousnames" \[ { "companypreviousname" " companypreviousname ", "startdate" " startdate ", "enddate" " enddate " } ], "alternateentities" \[ { "alternateentitycompanyname" " alternateentitycompanyname ", "alternateentitycountry" " alternateentitycountry ", "alternateentitystate" " alternateentitystate ", "alternateentitybusinessid" " alternateentitybusinessid " } ], "previousentities" \[ { "previousentitycompanyname" " previousentitycompanyname ", "previousentitycountry" " previousentitycountry ", "previousentitystate" " previousentitystate ", "previousentitybusinessid" " previousentitybusinessid " } ], "subsequententities" \[ { "subsequententitycompanyname" " subsequententitycompanyname ", "subsequententitycountry" " subsequententitycountry ", "subsequententitystate" " subsequententitystate ", "subsequententitybusinessid" " subsequententitybusinessid " } ], "companyidentifiers" \[ { "uid" " uid ", "identifiersystemcode" " identifiersystemcode ", "identifiersystemname" " identifiersystemname " } ], "companyfinancialsummary" { "profit" " profit ", "revenue" " revenue ", "cashinbank" " cashinbank ", "assets" \[ assets ], "currentliabilities" " currentliabilities ", "accountsdate" " accountsdate ", "fixedassets" " fixedassets ", "accountstype" " accountstype ", "currency" " currency " }, "controllingentity" { "companyname" " companyname ", "companycountry" " companycountry ", "companystate" " companystate ", "companybusinessid" " companybusinessid " }, "ultimatebeneficialowners" \[ { "name" " name " } ], "homecompany" { "homecompanyname" " homecompanyname ", "homecompanycountry" " homecompanycountry ", "homecompanystate" " homecompanystate ", "homecompanybusinessid" " homecompanybusinessid " }, "companybranch" " companybranch ", "companybranchstatus" " companybranchstatus ", "companyofficers" \[ { "officerid" " officerid ", "officername" " officername ", "officerposition" " officerposition ", "officeruid" " officeruid ", "officerstartdate" " officerstartdate ", "officerenddate" " officerenddate ", "officeroccupation" " officeroccupation ", "officerisinactive" " officerisinactive ", "officercurrentstatus" " officercurrentstatus ", "officeraddress" " officeraddress ", "officernationality" " officernationality ", "officerdob" " officerdob " } ], "corporategroupings" \[ { "companygroupingname" " companygroupingname " } ], "datasource" " datasource ", "dataretrievaldate" " dataretrievaldate ", "filings" \[ { "filingid" " filingid ", "filingtitle" " filingtitle ", "filingdescription" " filingdescription ", "filinguid" " filinguid ", "filingcode" " filingcode ", "filingname" " filingname ", "filingdate" " filingdate " } ], "industrycodes" \[ { "industrycodedescription" " industrycodedescription ", "industrycodescheme" " industrycodescheme " } ] } } } output parameters field name data type description result object the root object containing company information company object information about the company companyname string the name of the company businessid string the business id or registration number of the company country string the country where the company is located state string the state or region where the company is located companyaddressdetails string details about the company's address companyaddress object the address of the company currentcompanystatus string the current status of the company incorporationdate string the date of incorporation of the company isinactive string indicates if the company is inactive dissolutiondate string the date of dissolution of the company companytype string the type or category of the company registryurl string url to access the company's registry information numberofemployees string the number of employees in the company previousnames array an array of previous names associated with the company alternateentities array an array of alternate entities related to the company previousentities array an array of previous entities related to the company subsequententities array an array of subsequent entities related to the company companyidentifiers array an array of identifiers associated with the company companyfinancialsummary object financial summary information about the company controllingentity object information about the controlling entity of the company ultimatebeneficialowners array an array of ultimate beneficial owners of the company homecompany object information about the home company companybranch string indicates if the company is a branch companybranchstatus string the status of the company branch companyofficers array an array of officers associated with the company corporategroupings array an array of corporate groupings the company belongs to datasource string the source of the company data dataretrievaldate string the date when the data was retrieved filings array an array of filings related to the company industrycodes array an array of industry codes associated with the company 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!