Docs How-to guides References Error messages Company error messages

Company error messages

Posted 2025-01-02 | Updated 2025-02-18

Content of this guide

Overview

This guide dives into the most common HTTP error codes related to the company endpoints of KYC API V2, offering insights into what they mean, why they occur, and how to effectively address them.

/company/announcement/{kompanyId}

Error code and message Description
400 ERR_COMPANY_ANNOUNCEMENT_BAD_REQUEST The parameters passed to the request were invalid or malformed. Make sure you pass all required parameters. Check the error message returned for more information. The live documentation on https://kycapi.kompany.com can assist you with this process of constructing your request correctly.
400 ERR_ANNOUNCEMENT_INVALID_PARAM Invalid parameter detected. Please check the documentation.
500 ERR_COMPANY_ANNOUNCEMENT_SERVER_ERROR An unexpected error appeared during request execution. Please retry the request or get in contact with Customer Support team if the error persists.

/company/announcement/{kompanyId}/{announcementId}

Error code and message Description
404 ERR_COMPANY_ANNOUNCEMENT_NOT_FOUND An announcement with this id could not be found. Please make sure the identifier you passed is correct.

/company/dataset

Error code and message Description
400 ERR_DATASET_LIST_BAD_REQUEST The parameters sent with the request were not valid.
400 ERR_COMPANY_DATASET_NOT_SUPPORTED The country code is not supported for refresh dataset request.
400 ERR_DATASET_INVALID_PARAM Invalid parameter detected. Please check the documentation.
403 ERR_COMPANY_DATASET_NOT_ALLOWED Application is missing required feature for this dataset request.
404 ERR_COMPANY_DATASET_COMPANY_NOT_FOUND The company for which you have tried to request the dataset does not seem to exist. Please double check if the passed id is correct.

/company/dataset/{datasetid}

Error code and message Description
400 ERR_DATASET_BAD_REQUEST The parameters sent with the request were not valid.
400 ERR_COMPANY_DATASET_TRANSLATION_LANGUAGE_NOT_SUPPORTED The language code passed as the parameter was invalid. Valid values are: [OG, EN].
404 ERR_DATASET_NOT_FOUND The dataset you have tried to retrieve does not seem to exist. Please double check if the passed datasetId is correct.

/company/enhanced

Error code and message Description
400 ERR_ENHANCED_INVALID_PARAM Invalid parameter detected. Please check the documentation.
402 ERR_COMPANY_ENHANCED_DATASET_NOT_FOUND There is no dataset provided for the given input parameters.
403 ERR_COMPANY_ENHANCED_BO_NOT_ALLOWED Your KYC API plan does not permit ordering the Beneficial Owners Check document for Germany. Please contact Customer Support at solutions@moodys.com to request access.
404 ERR_COMPANY_BENEFICIAL_OWNERS_NOT_FOUND The company for which you have tried to request the dataset does not have any beneficial owners.
405 ERR_COMPANY_ENHANCED_NOT_SUPPORTED Enhanced datasets are currently not supported in this country. Please check the KYC API documentation for all available countries. If you have a specific request, get in contact with Customer Support team.
405 ERR_WRONG_ENHANCED_OPTION_REQUEST Requesting an enhanced dataset with both generalData and beneficialOwners options is not allowed.
412 ERR_COMPANY_SUPER_NOT_AVAILABLE Superdata not available for this company
412 ERR_COMPANY_ENHANCED_SHAREHOLDER_EXTRACTION_NOT_AVAILABLE Enhanced shareholder data extraction unavailable.
500 ERR_COMPANY_ENHANCED_MAXIMUM_DATA_RETRIEVAL_DEPTH_REACHED Maximum depth for enhanced company data retrieval reached.
503 ERR_COMPANY_SUPER_PROVIDER_ERROR Failed to retrieve superdata from provider
503 ERR_COMPANY_DATASET_PROVIDER_ERROR Unable to process your request! The company register didn’t respond correctly

/company/idSearch

Error code and message Description
400 ERR_COMPANY_IDSEARCH_BAD_REQUEST The parameters sent with the request were not valid.
400 ERR_ID_SEARCH_INVALID_PARAM Invalid parameter detected. Please check the documentation.

/company/indexSearch

Error code and message Description
400 ERR_COMPANY_INDEXSEARCH_BAD_REQUEST The parameters sent with the request were not valid.
400 ERR_COMPANY_DATASET_INDEX_COUNTRY_NOT_SUPPORTED The country code is not supported for index dataset request.
400 ERR_INDEX_SEARCH_INVALID_PARAM Invalid parameter detected: ‘banana’. Please check the documentation.
403 ERR_COMPANY_NAMESEARCH_INVALID_COUNTRY_EXTENSION The country extension sent with the request is not valid.

/company/liveSearch

Error code and message Description
400 ERR_COMPANY_LIVESEARCH_BAD_REQUEST The parameters sent with the request were not valid.
400 ERR_LIVE_SEARCH_INVALID_PARAM Invalid parameter detected. Please check the documentation.
412 ERR_COMPANY_DEEP_NAMESEARCH_TOO_MANY_MATCHES The parameters used in the search yielded too many matches.
412 ERR_COMPANY_DEEP_NUMSEARCH_NOT_AVAILABLE Deep search from LIVE data is not available for this jurisdiction.
503 ERR_COMPANY_DEEP_NUMSEARCH_PROVIDER_ERROR Unable to retrieve data from the register!
503 ERR_COMPANY_DEEP_NAMESEARCH_PROVIDER_ERROR Unable to retrieve data from the register!
504 ERR_PROVIDER_TIMEOUT Timeout error with a provider.
Back Next