MENA Region Company Search API

4 min

Introduction

The Signzy Global Businesses API is a RESTful API that provides access to company search functionality for businesses across the world. With this API, you can search for companies by name or company number in various countries across the Middle East and North Africa (MENA) region.

Sample cURL

curl --request POST \
  --url https://signzy.tech/api/v2/patrons/..your-patron-id../globalbusinesses \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"task":"menaCompanySearch","essentials":{"companyName":"...companyName...","companyNumber":"...companyNumber...","countryID":"...countryID..."}}'

Parameter	Type	Description
task	string	The specific task to be performed by the API. In this case, set it to "menaCompanySearch".
companyName	string	The name of the company to be searched. This is an optional field and can be omitted if you have the company number (see below).
companyNumber	string	The registration number of the company to be searched. This is an optional field and can be omitted if you have the company name (see above).
countryID	string	The ISO 3166-1 alpha-2 code of the country to search in. For example, "AE" for United Arab Emirates, "SA" for Saudi Arabia, etc.

Sample API Response

 {
      "result": [
      {
          "companyName": "...companyName...",
          "uid": "...uid...",
          "companyNumber": "...companyNumber...",
          "countryID": "...countryID...",
          "country": "...country...",
          "city": "...city...",
          "address": {
              "fullAddress": "...full address...",
              "street": "...street...",
              "area": "...area...",
              "town": "...town...",
              "pobox": "...pobox..."
          },
          "postalCode": "...postal code...",
          "status": "...status...",
          "companyType": "...companyType...",
          "lastUpdateDate": "...lastUpdateDate..."
      }
    ]
  }

Field Name	Data Type	Description
companyName	string	The name of the company.
uid	string	Unique ID of the company.
companyNumber	string	The registration number of the company.
countryID	string	The ID of the country where the company is registered.
country	string	The name of the country where the company is registered.
city	string	The name of the city where the company is registered.
address	object	Object containing the complete address of the company.
address.fullAddress	string	Full address of the company.
address.street	string	The name of the street where the company is located.
address.area	string	The name of the area where the company is located.
address.town	string	The name of the town where the company is located.
address.pobox	string	The post office box number of the company.
postalCode	string	The postal code of the company's location.
status	string	The status of the company.
companyType	string	The type of the company.
lastUpdateDate	string	The date of the last update made to the company information.