---
title: Global Company Display API
slug: us-apis/global-company-display-api
description: Learn how to use the Signzy Global Businesses API to effortlessly search for companies in the MENA region. This document covers all the necessary details, including cURL examples, request body parameters, and even a sample API response. Find out about sup
createdAt: 2023-04-08T02:25:02.000Z
---

## Introduction

The **Global Business Company Display API** is designed to provide comprehensive company information after a company has been identified using the **Global Business Company Lookup API**. While the Lookup API returns a list of matching companies along with basic information and data availability indicators, the Display API retrieves the complete company profile for a selected company using the **searchId** and **UID** obtained from the lookup response.

This API returns enriched business information such as company registration details, legal status, company type, issue and expiry dates, registered address, and other verified company attributes from authoritative business registries across multiple countries.

## API Details

## Sample cURL

:::CodeblockTabs
Pre-Production

```curl
curl --location 'https://api-preproduction.signzy.app/api/v3/company-search/global-business/display' \
--header 'Authorization: <auth_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchId": "<input_search_id>",
    "uid": "<input_uuid>"
}'
```

Production

```curl
curl --location 'https://api.signzy.app/api/v3/company-search/global-business/display' \
--header 'Authorization: <auth_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchId": "<input_search_id>",
    "uid": "<input_uuid>"
}'
```
:::

### Request Body Parameters

| **Parameter** | **Type** | **Description**                                                                                                                                                                                                    | **Required** |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| searchId      | String   | Search session ID from the Lookup API response.<br />Digits only (0-9).<br />Max 50 characters.<br />Cannot be empty.                                                                                              | Yes          |
| uid           | String   | Company name associated with the EIUnique company identifier (from the Lookup response) of the company to fetch.<br />Alphanumeric only (letters & numbers). <br />1–70 characters.<br />Trimmed; cannot be empty. | Yes          |

## Sample API Response

:::CodeblockTabs
Result Found

```json
{
    "result": {
        "searchId": 1234567,
        "searchResult": {
            "uid": "AE10234567",
            "companyName": "ABC TECHNOLOGIES LLC",
            "tradingName": "ABC",
            "companyNumber": "CN-1234567",
            "city": "Dubai",
            "address": "Office 123, Business Bay, Dubai, UAE",
            "postalCode": "00000",
            "status": "Active",
            "companyType": "Limited Liability Company",
            "issueDate": "15/03/2015",
            "expiryDate": "14/03/2025"
        }
    }
}
```
:::

### Response Body parameters

**Top-Level Object Fields**

| **Field**           | **Type** | **Description**                                          |
| ------------------- | -------- | -------------------------------------------------------- |
| result              | Object   | Container for the full company display response.         |
| result.searchId     | Number   | Echoes the search session ID the profile belongs to.     |
| result.searchResult | Object   | he complete profile of the selected company (see below). |

**Result Details**

| **Field**     | **Type** | **Description**                                              |
| ------------- | -------- | ------------------------------------------------------------ |
| uid           | String   | Unique company identifier (matches the requested uid<br />). |
| companyName   | String   | Registered legal name of the company.                        |
| tradingName   | String   | Trading / business name, if different from the legal name.   |
| companyNumber | String   | Official registration / company number from the registry.    |
| city          | String   | City where the company is registered.                        |
| address       | String   | Full registered address.                                     |
| postalCode    | String   | Postal / ZIP code of the registered address.                 |
| status        | String   | Legal status of the company.                                 |
| companyType   | String   | Legal form / company type (e.g. Limited Liability Company).  |
| issueDate     | String   | Registration / issue date, normalized to dd/mm/yyyy.         |
| expiryDate    | String   | Licence / registration expiry date.                          |

****

| 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

:::CodeblockTabs
Bad Request 400

```json
{
    "error": {
        "name": "error",
        "message": "searchId is required",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

Bad Request 400

```json
{
    "error": {
        "name": "error",
        "message": "uid must contain only alphanumeric characters (letters and numbers)",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

Data Not Found 404

```json
{
    "error": {
        "name": "error",
        "message": "No company data found",
        "status": 404,
        "reason": "NOT_FOUND",
        "type": "Not Found",
        "statusCode": 404
    }
}
```

Upstream Error 409

```json
{
    "error": {
        "name": "error",
        "message": "Upstream Error",
        "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".                                                            |

:::hint{type="info"}
### 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!
:::

