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 regNo where available. If a unique identifier is not available, use a combination of the companies registered postCode and name for the next best hit rate.

SecuritybearerToken
Request
query Parameters
page
integer
Default: 1

Starting page number.

pageSize
integer

Number of items to return per Page.

countries
required
string (Creditsafe.GlobalData.CountryCode)

comma-separated list of iso-2 country codes.
The code PLC 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"
Example: countries=GB,FR
language
string or null = 2 characters
Default: null

Only used for Countries where more than one Company Name exists for different languages e.g. Japanese Kanji and English.
Country - Languages Available
Japan [JP] - EN & JA

id
string or null
Default: 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 or null

Safe Number - Identifier for Companies in Creditsafe's Home Countries.

regNo
string or 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 or null

Company VAT Number

name
string or null

Company Name

tradeName
string or null

Trade Name of the Company, typically used in Countries where Name is not uniquely registered.

acronym
string or 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 or null

Provide as true to find Companies matching a Name exactly.
A list of countries this is available at Here.

address
string or null
street
string or null
Default: null

Address part identifier - Street of the Company

houseNo
string or null

Address part identifier - House/Building Number of the Company

city
string or null

Address part identifier - City of the Company

postCode
string or null

Address part identifier - Postcode/Zip Code of the Company. Can be provided partially to extend to a region with a * as a wildcard. I.e. CF* can represent all postcodes starting with CF.

province
string or null

Address part identifier - Province/State of the Company

callRef
string or null
Default: 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 (Creditsafe.GlobalData.OfficeType)
Enum: "registered" "trading" "headOffice" "branch" "subsidiary" "franchise" "franchisor" "singleOffice" "other"
phoneNo
Array of strings or null

Provides Array of phone numbers or Null

status
string (Creditsafe.GlobalData.CompanyStatus)

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 (Creditsafe.GlobalData.CompanyType)

NonLtdNonReg is only available for countries in Norway.

Enum: "NotSet" "Ltd" "NonLtd" "NonLtdNonReg"
website
string or null
customData
string or null

Not currently used.

Responses
200
400

Bad Request

401

Invalid Token

get/companies
Request samples 
Response samples 
application/json
{
  • "correlationId": "string",
  • "messages": [
    ],
  • "totalSize": 0,
  • "companies": [
    ]
}
➔ Next to Company Credit Report