Creditsafe Connect (1.10.9)
This is the full Connect API and contains all available endpoints. For additional information, integration processes, and supplementary documentation, please use the targeted product
The Creditsafe Connect API is a REST API that provides access to the Creditsafe Global Company Database. This allows you to:
- Control your master data
- Utilize up-to-date Business and Director information, enhancing your onboarding and qualification processes
- Receive alerts when your customer's and supplier's Credit Report changes
To start your Creditsafe Connect API integration you will need to have activated your account and set a password by following the instructions in your Welcome Email. If you have not received a Welcome Email please contact your Creditsafe Account Manager.
By default, you will have been setup on our Sandbox environment.
Using a REST API client construct an /authenticate
POST request and enter your username & password (case-sensitive) into the POST body. A successful response will return an authentication token
.
Use the authentication token
in an Authorization
header on all other Creditsafe Connect calls as proof of your authenticity.
https://connect.sandbox.creditsafe.com/v1/
https://connect.creditsafe.com/v1/
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.
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.
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.
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.
Verify
Verify is an exclusive add-on to Creditsafe's company credit reports, designed to assist businesses in making smarter, quicker, and more informed credit decisions. For new or small companies that lack a detailed financial footprint, Verify offers unparalleled insights by screening company directors and the individuals behind businesses for their personal financial stability and identity.
Using Verify, you can confidently assess a company's leadership, using trusted public datasets that highlight potential financial concerns, such as CCJs or Insolvencies and confirm that they reside at an address on the Electoral roll.
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details
- Production server
https://connect.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/9a7ae0c8-f473-4ab6-8dbb-03fc061630cc/details \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'
{ "profileId": "2770ac31-8d12-4f69-8f93-326e93cd8c34", "legalName": "string", "tradingName": "string", "aliases": [ "string" ], "activity": "string", "description": "string", "contactName": "string", "email": "string", "website": "string", "telephone": "string", "turnover": { "currencyCode": "eur", "amount": 0 }, "assetsUnderManagement": { "currencyCode": "eur", "amount": 0 }, "dateOfBirth": "2024-02-27", "countryCode": "string", "vatNo": "string", "isListedOnExchange": true, "exchangeName": "string", "organizationNumber": "string", "internalContact": "string", "internalEmail": "string", "createdAt": "2023-08-07T07:12:43.331308Z", "createdById": 101562008, "createdBy": "Amol", "modifiedAt": "2023-08-08T07:16:27.734212Z", "modifiedById": 101562008, "modifiedBy": "Amol", "noteCount": 0, "attachmentCount": 2, "correlationId": "70fd7603-1f75-4de6-8e38-a3c79ac24947" }
Name of the Business or Individual
Maximum length is 150 characters
Name of any Aliases
Maximum length of each alias is 150 characters
Activity of the Business e.g. NAIC S/SIC Codes
Valid for profile types - Trust, Company, Partnership, OtherEntity and PLC
Maximum length of activity is 150 characters
Description of the business/individual entity
Valid for the profile types Trust, Company, Partnership, OtherEntity and PLC
Website address of the entity
Valid for the profile types Trust, Company, Partnership, OtherEntity and PLC
Telephone number of the entity.
Valid for the profile types Trust, Company, Partnership, OtherEntity and PLC
Property valid for profile type - Trust, Company, Partnership, OtherEntity and PLC
Internal contact name to contact regarding this profile,
Property valid for profile type - Trust, Company, Partnership, OtherEntity and PLC.
Internal email address to contact regarding this profile.
Property valid for profile type - Trust, Company, Partnership, OtherEntity and PLC
Date YYYY-MM-DD or YYYY format. Must be after 1900 and not in the future
Valid for the profile types Individual and SoleTrader
Two-letter country code ISO-3166-2.
Valid for the profile types Individual and SoleTrader
Tax Identification Number of the business
Valid for the profile types Company, Partnership, OtherEntity and PLC
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details
- Production server
https://connect.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/9a7ae0c8-f473-4ab6-8dbb-03fc061630cc/details \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"legalName": "Creditsafe Ltd",
"tradingName": null,
"aliases": null,
"activity": "62409",
"description": "Example Free Text",
"contactName": null,
"email": "example@creditsafe.com",
"website": "www.creditsafe.com",
"telephone": null,
"turnover": {
"currencyCode": "eur",
"amount": 0
},
"assetsUnderManagement": {
"currencyCode": "eur",
"amount": 0
},
"organizationNumber": "12345678",
"internalContact": null,
"internalEmail": null,
"dateOfBirth": "2024-03-25",
"countryCode": "GB",
"vatNo": "GB12345678",
"isListedOnExchange": null,
"exchangeName": null
}'
{ "profileId": "faebe71b-2bf8-4bdb-9b67-258e4d6aa00a", "legalName": "string", "tradingName": "string", "aliases": [ "string" ], "activity": "string", "description": "string", "contactName": "string", "email": "string", "website": "string", "telephone": "string", "turnover": { "currencyCode": "string", "amount": 0.1 }, "assetsUnderManagement": { "currencyCode": "string", "amount": 0.1 }, "dateOfBirth": "2019-08-24", "countryCode": "string", "vatNo": "string", "isListedOnExchange": true, "exchangeName": "string", "organizationNumber": "string", "internalContact": "string", "internalEmail": "string", "internationalScore": "string", "createdAt": "2019-08-24T14:15:22Z", "createdById": 0, "createdBy": "string", "modifiedAt": "2019-08-24T14:15:22Z", "modifiedById": 0, "modifiedBy": "string", "noteCount": 0, "attachmentCount": 0 }
The building details of the address being created. Must have a maximum length of 250 characters.
The street of the address being created. Must have a maximum length of 250 characters.
The city of the address being created. Must have a maximum length of 250 characters.
The region of the address being created. Must have a maximum length of 250 characters.
The postal code of the address being created. Must have a maximum length of 50 characters.
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details/addresses
- Production server
https://connect.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details/addresses
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/{profileId}/details/addresses' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"type": "registered",
"buildingDetails": "string",
"street": "string",
"city": "string",
"region": "string",
"postalCode": "string",
"countryCode": "string",
"description": "string"
}'
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "buildingDetails": "string", "street": "string", "city": "string", "region": "string", "postalCode": "string", "countryCode": "string", "type": "string", "description": "string", "createdAt": "2019-08-24T14:15:22Z", "createdById": 0, "createdBy": "string", "modifiedAt": "2019-08-24T14:15:22Z", "modifiedById": 0, "modifiedBy": "string" }