Connect API Catalog
/
Credit and Risk
/
API Documentation
/
Search And Report Schemas/Criteria
/
Return Languages Available For Company Reports For Selected Country

Credit and Risk (1.0.0)

The Credit and Risk API provides access to a comprehensive suite of endpoints designed to deliver critical business insights. This API enables users to authenticate, search for companies and directors, retrieve detailed credit and risk reports, access official company filing documents, and manage fresh investigation requests for companies not available in the instant database.

Download OpenAPI description
creditAndRisk.json
creditAndRisk.yaml
Languages
Servers
Sandbox server

https://connect.sandbox.creditsafe.com/v1/

Production server

https://connect.creditsafe.com/v1/

Authentication

Endpoints to authenticate and generate an Authentication Token.

Operations

Search And Report Schemas/Criteria

Endpoints to retrieve the structure of the Company and Director Search Criteria, Report Schemas, and available Report Languages for a specific country.

These endpoints provide the necessary information to validate responses, understand search parameters, and determine localization options for reports.

Operations

Return Languages Available For Company Reports For Selected Country

Request

Endpoint which returns available languages for a report. The JSON structure of the report is language invariant, but field content will return in the selected language where available.

Note: The availability of field content in a specific language depends on the data source. If certain properties in the report are not available in the chosen language, they will default to English. As a result, only a certain percentage of the report may appear in the selected language.

Path
countryCodestringrequired

Accepts valid iso-2 country code

Example: NL
curl -i -X GET \
  https://connect.sandbox.creditsafe.com/v1/access/countries/NL/reportLanguages \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
reportLanguagesArray of strings
Example: ["NL"]
Response
application/json
{
  "reportLanguages": [
    "NL"
  ]
}

Company Search Criteria

Request

Returns the set of available Company Search parameters/fields for a provided list of countries.

Query
countriesstringrequired

A comma separated list of ISO/Alpha 2 format country codes, or singular country Code. e.g. US,GB will return the common searchable Company fields in the United States and Great Britain.

curl -i -X GET \
  'https://connect.sandbox.creditsafe.com/v1/companies/searchcriteria?countries=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful

Bodyapplication/json
correlationIdstring

A unique ID assigned to this request.

countriesArray of strings(CreditsafeGlobalDataCountryCode)
Items Enum"AF""AX""AL""DZ""AS""AD""AO""AI""AQ""AG"
languagesArray of strings

Available languages to perform a company search in the country queried

criteriaSetsArray of objects(CreditsafeGlobalDataSearchCriteriaSchema)
Response
application/json
{
  "correlationId": "string",
  "countries": [
    "AF"
  ],
  "languages": [
    "string"
  ],
  "criteriaSets": [
    { … }
  ]
}

People/Director Search Criteria

Request

Returns the set of available People Search parameters/fields for a provided list of countries.

Query
countriesstring

A comma separated list of ISO/Alpha 2 format country codes, or singular country Code. e.g. US,GB will return the common searchable People/Director fields in the United States and Great Britain.

curl -i -X GET \
  'https://connect.sandbox.creditsafe.com/v1/people/searchcriteria?countries=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
messagesArray of objects(CreditsafeGlobalDataMessage)

Provides information about the request and the response.

countriesCriteriaArray of objects(CreditsafeGlobalDataSearchCriteriaSchemaCountryDirector)

The list of available parameters for the search in the given country.

customDataArray of objects(CreditsafeGlobalDataCustomDataEntrySchema)
Response
application/json
{
  "messages": [
    { … }
  ],
  "countriesCriteria": [
    { … }
  ],
  "customData": [
    { … }
  ]
}

Report Schema Structure Per Country

Request

Returns the Company Report JSON schema of the provided country. Largely redundant as the Company Report 200 response is defined as a superset of all country's JSON schemas and can be used for any country.

Path
countryCodestringrequired

ISO2 / Alpha 2 Country Code

Query
sectionstringrequired

Use CompanyReportResponse for the Company Credit Report JSON schema.

Value"CompanyReportResponse"
templatestring

For Templated Company Report JSON Schemas. Selection of templates can be found here: Templates

curl -i -X GET \
  'https://connect.sandbox.creditsafe.com/v1/companies/schema/{countryCode}?section=CompanyReportResponse&template=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
object
Response
application/json
{}

Companies

Endpoints to search for Companies in the Creditsafe Global Company Database. Companies are uniquely identified by the connectId - the identifier used to order a Company Credit Report. The Company Credit Report is a JSON object comprising of key business and financial data points such as Credit Score & Limit, Industry Code, Directors, Balance Sheet and Negative Information. A full list of Company data points can be found in the Data Matrix, in the help resources.

Operations

People/Directors

Endpoints to find People/Directors and order Director Reports. A Director Report will contain a person's registered information and Active & Previous Directorships, where available. This endpoint is not advised to get a list of directors for a specific Company. Instead, order a Company Credit Report using the /companies/{id} endpoint, and use the directors section in the response.

Operations

Images

Endpoints to order official Company Image/Filing Documents from source. Company Filings such as Annual Account Statements, Annual Returns, Liquidations and Changes of Registered Information can be downloaded as PDFs, and are typically used as a resource in extended company auditing/compliance.

Operations

Fresh Investigations

Endpoints to manage Fresh Investigation requests. With the need for accurate data, you can check on any company that is not available within our instant online database by placing a Fresh Investigation (Offline Order). Depending on the market, the information we obtain will vary. Using official sources and registries we are able to quickly answer questions about a company's stability and financial health. Where official information is not available we will conduct a direct interview with the business.

Operations