# Company Search

Endpoint to search for Companies according to the provided Search Criteria. To get the most relevant results, it is recommended to use a unique identifier such as  where available. If a unique identifier is not available, use a combination of the companies registered  and  for the next best hit rate.

Endpoint: GET /companies
Version: 1.10.9
Security: bearerToken

## Query parameters:

  - `page` (integer)
    Starting page number.

  - `pageSize` (integer)
    Number of items to return per Page.

  - `countries` (string, required)
    comma-separated list of iso-2 country codes.The code  can be used here to search for companies of this type across all countries.
    Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "GS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "XK", "SS", "SX", "CW", "BQ", "WW", "PLC"

  - `language` (string,null)
    Only used for Countries where more than one Company Name exists for different languages e.g.  Japanese Kanji and English.Country -  Languages AvailableJapan [JP] - EN & JA

  - `id` (string,null)
    connectId - The primary Company identifier that is used to uniquely identify all companies across Creditsafe's Universe and Partner Network. This is returned on all Company Search Results. Use this field to use in other operations such as Ordering Company Credit Report by Id, and Adding Company to Monitoring Portfolio.

  - `safeNo` (string,null)
    Safe Number - Identifier for Companies in Creditsafe's Home Countries.

  - `regNo` (string,null)
    Local Company Identifier - The Company identifier associated with it's Domestic Filing Agency. i.e. French SIREN/SIRET, United Kingdom Companies House CRN.

  - `vatNo` (string,null)
    Company VAT Number

  - `name` (string,null)
    Company Name

  - `tradeName` (string,null)
    Trade Name of the Company, typically used in Countries where Name is not uniquely registered.

  - `acronym` (string,null)
    A (non-unique) identifier to look for Companies by their more commonly known acronym rather than their lesser known full name. Acronym is predominantly available on French Companies.

  - `exact` (boolean,null)
    Provide as  to find Companies matching a Name exactly.A list of countries this is available at Here.

  - `address` (string,null)

  - `street` (string,null)
    Address part identifier - Street of the Company

  - `houseNo` (string,null)
    Address part identifier - House/Building Number of the Company

  - `city` (string,null)
    Address part identifier - City of the Company

  - `postCode` (string,null)
    Address part identifier - Postcode/Zip Code of the Company. Can be provided partially to extend to a region with a  can represent all postcodes starting with CF.

  - `province` (string,null)
    Address part identifier - Province/State of the Company

  - `callRef` (string,null)
    This parameter allows users to assign a unique identifier to their API queries. By using a callRef, it facilitates easier tracking and logging within Connect. If you provide a callRef, the Connect team can later retrieve and identify the specific requests associated with that identifier, enabling detailed tracing of interactions.

  - `officeType` (string,null)
    Enum: "registered", "trading", "headOffice", "branch", "subsidiary", "franchise", "franchisor", "singleOffice", "other"

  - `phoneNo` (array,null)
    Provides Array of phone numbers or Null

  - `status` (string,null)
    High-level status. Values include "Active", "NonActive", "Pending" and "Other". Note - “Pending” indicates that the entity has entered into a legal process such as insolvency or liquidation, and “Other” indicates an unknown status.
    Enum: "Active", "NonActive", "Pending", "Other"

  - `type` (string)
    is only available for countries in Norway.
    Enum: "NotSet", "Ltd", "NonLtd", "NonLtdNonReg"

  - `website` (string,null)

  - `customData` (string,null)
    Not currently used.

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected