Global Company Lookup : Fetch API

Introduction

Allows businesses to retrieve the results of a previously initiated global company search using the request identifier returned by the Initiate API. Once the search has been completed, the API returns detailed company information, including company names, unique identifiers, registration details, operational status, and other available business attributes from supported countries. By separating request initiation from result retrieval, the Fetch API enables efficient handling of long-running KYB processes while providing a seamless and scalable mechanism for accessing comprehensive company information for compliance, due diligence, and business verification workflows.

API Details

Sample cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/company-search/global-business-getData' \
--header 'Authorization:<auth_token>' \
--header 'Content-Type: application/json' \
--data '{
 "requestId":"<request_id>"
}'

Request Body Parameters

Parameter	Type	Description	Required
requestId	String	The responseId returned by the Generate API. Must be a valid request ID (exactly 24 hexadecimal characters).	Yes

Sample API Response

{
    "result": [
        {
            "responseId": "1a2b3c4d5e6f7a8b9c0d1e2f",
            "companyName": "ACME EXAMPLE TRADING COMPANY",
            "uid": "KWC0100001",
            "companyNumber": "1001",
            "countryID": "KW",
            "country": "Kuwait",
            "city": "Kuwait City",
            "address": {
                "fullAddress": "POBOX: 1000.  Street: Sample Street.  Area: Commercial Area No. 1.  Town: Kuwait City. ",
                "street": "Sample Street",
                "area": "Commercial Area No. 1",
                "town": "Kuwait City",
                "pobox": "1000"
            },
            "postalCode": "10001",
            "status": "Available",
            "companyType": "Available",
            "lastUpdateDate": "01/01/2025",
            "tradingName": "ACME EXAMPLE TRADING",
            "issueDate": "Not Available",
            "expiryDate": "Not Available",
            "crComplyHits": "",
            "searchId": 10001
        }
    ]
}

Response Body parameters

Top-Level

Field	Type	Description
result	Object / Array	Container. An object for the processing / message variants; an array of company objects for the fulfilled-results variant.

Processing variant

Field	Type	Description
responseId	String	Echoes the request id.
status	String	processing — results not ready yet; poll again.

Company object (fulfilled-results variant)

Field	Type	Description
responseId	String	The request id, added to every company object.
companyName	String	Registered company name.
uid	String	Unique company identifier — feed this + searchId into the Display API.
companyNumber	String	Official registration number.
countryID	String	ISO alpha-2 code used in the search.
country	String	Full country name.
city	String	City of registration.
address	Object	Structured address (see below).
address.fullAddress	String	Complete raw address string.
address.street	String	Street, parsed from the raw address.
address.area	String	Area, parsed from the raw address.
address.town	String	Town, parsed from the raw address.
address.pobox	String	PO Box, parsed from the raw address.
postalCode	String	Postal code.
status	String	Company legal status (e.g. Active).
companyType	String	Legal form / company type.
lastUpdateDate	String	Registry last-updated date (dd/mm/yyyy).
tradingName	String	Trading name, if different.
issueDate	String	Registration/issue date (dd/mm/yyyy).
expiryDate	String	Licence expiry date (dd/mm/yyyy).
crComplyHits	String	Compliance-screening hit indicator (empty when none).
searchId	Number	Search session id — pairs with uid for the Display API.

Supported Countries & Country IDs

Country Code	Country Name
DZ	Algeria
BH	Bahrain
EG	Egypt
IR	Iran
IQ	Iraq
IL	Israel
JO	Jordan
KW	Kuwait
LB	Lebanon
LY	Libya
MA	Morocco
OM	Oman
PS	Palestine
QA	Qatar
SA	Saudi Arabia
SY	Syria
TN	Tunisia
AE	United Arab Emirates
YE	Yemen
AF	Afghanistan
AX	Aland Islands
AL	Albania
AS	American Samoa
AD	Andorra
AO	Angola
AQ	Antarctica
AG	Antigua & Barbuda
AR	Argentina
AM	Armenia
AW	Aruba
AU	Australia
AT	Austria
AZ	Azerbaijan
BS	Bahamas
BD	Bangladesh
BB	Barbados
BY	Belarus
BE	Belgium
BZ	Belize
BJ	Benin
BM	Bermuda
BT	Bhutan
BO	Bolivia, (Plurinational State Of)
BQ	Bonaire, Saint Eustatius And Saba
BA	Bosnia and Herzegovina
BW	Botswana
BV	Bouvet Island
BR	Brazil
IO	British Indian Ocean Territory
BN	Brunei Darussalam
BG	Bulgaria
BF	Burkina Faso
BI	Burundi
KH	Cambodia
CM	Cameroon
CA	Canada
(empty)	Canary Islands
CV	Cape Verde
KY	Cayman Islands (the)
CF	Central African Republic (the)
TD	Chad
CL	Chile
CN	China (the People's Republic of China, PRC)
CX	Christmas Island
CC	Cocos (Keeling) Islands
CO	Colombia
KM	Comoros (the)
CD	Congo (the Democratic Republic of the)
CG	Congo (the)
CK	Cook Islands (the)
CR	Costa Rica
CI	Côte d'Ivoire
HR	Croatia
CU	Cuba
CW	Curacao
CY	Cyprus
CZ	Czechia
DK	Denmark
DJ	Djibouti
DM	Dominica
DO	Dominican Republic (the)
EC	Ecuador
SV	El Salvador
GQ	Equatorial Guinea
ER	Eritrea
EE	Estonia
SZ	Eswatini (Kingdom of, previously Swaziland)
ET	Ethiopia
FK	Falkland Islands (Malvinas)
FO	Faroe Islands (the)
FJ	Fiji
FI	Finland
FR	France
GF	French Guiana
PF	French Polynesia
GA	Gabon
GM	Gambia (the)
GE	Georgia
DE	Germany
GH	Ghana
GI	Gibraltar
GR	Greece
GL	Greenland
GD	Grenada
GP	Guadeloupe
GU	Guam
GT	Guatemala
GG	Guernsey
GN	Guinea
GW	Guinea-Bissau
GY	Guyana
HT	Haiti
HM	Heard and McDonald Islands
VA	Holy See (Vatican City State)
HN	Honduras
HK	Hong Kong (Special Administrative Region of the People's Republic of China)
HU	Hungary
IS	Iceland
IN	India
ID	Indonesia
IE	Ireland
IM	Isle of Man
IT	Italy
JM	Jamaica
JP	Japan
JE	Jersey
KZ	Kazakhstan
KE	Kenya
KI	Kiribati
KP	Korea (the Democratic People's Republic Of)
KR	Korea, (the Republic Of)
XK	Kosovo
KG	Kyrgyzstan
LA	Lao People's Democratic Republic (the)
LV	Latvia
LS	Lesotho
LR	Liberia
LI	Liechtenstein
LT	Lithuania
LU	Luxembourg
MO	Macao (MSAR-Special Administrative Region of the People's Republic of China)
MK	Macedonia (the Former Yugoslav Republic of)
MG	Madagascar
MW	Malawi
MY	Malaysia
MV	Maldives
ML	Mali
MT	Malta
MH	Marshall Islands (the)
MQ	Martinique
MR	Mauritania
MU	Mauritius
YT	Mayotte
MX	Mexico
FM	Micronesia (Federated States of)
MD	Moldova (the Republic of)
MC	Monaco
MN	Mongolia
ME	Montenegro
MS	Montserrat
MZ	Mozambique
MM	Myanmar (formerly Burma)
NA	Namibia
NR	Nauru
NP	Nepal
NL	Netherlands (the)
NC	New Caledonia
NZ	New Zealand
NI	Nicaragua
NE	Niger (the)
NG	Nigeria
NU	Niue
NF	Norfolk Island
MP	Northern Mariana Islands (the)
NO	Norway
PK	Pakistan
PW	Palau
PA	Panama
PG	Papua New Guinea
PY	Paraguay
PE	Peru
PH	Philippines (the)
PN	Pitcairn Island
PL	Poland
PT	Portugal
PR	Puerto Rico
RE	Réunion
RO	Romania
RU	Russian Federation
RW	Rwanda
BL	Saint Barthelemy
SH	Saint Helena, Ascension and Tristan da Cunha
KN	Saint Kitts and Nevis
LC	Saint Lucia
MF	Saint Martin
PM	Saint Pierre and Miquelon
VC	Saint Vincent and the Grenadines
SM	San Marino
ST	Sao Tome and Principe
SN	Senegal
RS	Serbia
SC	Seychelles
SL	Sierra Leone
SG	Singapore
SX	Sint Maarten
SK	Slovakia
SI	Slovenia
SB	Solomon Islands
SO	Somalia
ZA	South Africa
GS	South Georgia And The South Sandwich Islands
SS	South Sudan
ES	Spain
LK	Sri Lanka
SD	Sudan (the)
SR	Suriname
SJ	Svalbard and Jan Mayen Islands
SE	Sweden
CH	Switzerland
TW	Taiwan (Republic of China, ROC)
TJ	Tajikistan
TZ	Tanzania, United Republic Of
TH	Thailand
TL	Timor-Leste, Democratic Republic of
TG	Togo
TK	Tokelau
TO	Tonga
TT	Trinidad and Tobago
TR	Turkiye
TM	Turkmenistan
TC	Turks and Caicos Islands (the)
TV	Tuvalu
UG	Uganda
UA	Ukraine
GB	United Kingdom of Great Britain and Northern Ireland (the)
UM	United States Minor Outlying Islands
US	United States of America (the)
UY	Uruguay
UZ	Uzbekistan
VU	Vanuatu,Republic of
VE	Venezuela (Bolivarian Republic Of)
VN	Viet Nam
VG	Virgin Islands (British)
VI	Virgin Islands (U.S.)
WF	Wallis and Futuna
EH	Western Sahara
WS	Western Samoa
ZM	Zambia
ZW	Zimbabwe

Sample Error

{
    "error": {
        "name": "error",
        "message": "Unexpected request state",
        "status": 409,
        "reason": "CONFLICT",
        "type": "Conflict",
        "statusCode": 409
    }
}

Error Response Parameters

Parameter	Description
error	Container object present on every failed request; wraps all error details.
error.message	Human-readable description of why the request failed.
error.status	HTTP status code of the failure.
error.reason	Standardized Signzy error category.
error.type	HTTP status text corresponding to the status code.
error.statusCode	HTTP status code.
error.name	Always "error".

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!