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
Pre-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"
}'
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"
}'
﻿
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
JSON
{
   "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..."
                  }
               ]
            }
         }
      ]
   }
}

{
   "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
JSON
{
  "error": {
    "statusCode": 409,
    "name": "error",
    "message": "Error in getting data from upstream",
    "status": 409
  }
}
{
  "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 [email protected]. 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!
﻿

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

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

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

State Code	Province
BC	British Columbia
NB	New Brunswick
NL	Newfoundland and Labrador
NS	Nova Scotia
ON	Ontario
PE	Prince Edward Island
QC	Quebec

STATE CODE	STATE NAME
AZ	Abu Dhabi (UAE)
DU	Dubai (UAE)

STATE CODE	STATE NAME
RE	Reunion

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.

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).

Did this page help you?

Global Business Lite - Live Search

Global Business Advanced - Search Entity by ID