You can create a request with only the company_id, and the necessary data will be retrieved from the company entity.

A 422 - Unprocessable Error will be raised if the company entity is missing company_number or country_code.

Alternatively, you can override the company entity details by sending company_number, company_name, and country_code alongside the company_id in the request body. The credit report returned will be associated with the company_id on the request.

As a third option, you can send a 3rd party data provider provider_id for a specific company within their system. The credit report returned will be associated with the company_id on the request.

If resolving the credit report to a single company is not possible, the response will have a status of TooManyResults. You can resolve this picklist using the POST /v2/company-credit-reports/picklist endpoint.

201Credit Report Request

400Company Entity Deleted/Not Found or Country Not Recognised

401Unauthorized

403Insufficient Credits

422Company Entity Missing Information

429Too Many Requests

500Internal Server Error