GET
/v2/credit-reportFind available reports
Search by country and company identifiers; retain the returned source ID.
Business Credit Reports API & MCP
Credit intelligence.
Inside your
workflow.
Bring company credit reports into your systems. Give your AI assistant the financial and ownership evidence behind the review.
REST API · MCP · Webhooks
A company record. A connected workflow.32 SEC
Built for the way enterprise teams work.
Credit & financeProcurementProduct & engineering
01 / The data behind the decision
A report you can read.
Data you can build with.
Connect the assessment to the company, its accounts and its ownership. Explore the information that can support your review.
Available reports, fields and history depend on the company and country. Explore our data sources ↗
600Mcompany records
200countries
Global company intelligence coverage.
Validate credit-report and field availability for your company list.
02 / Company data for AI
Give your assistant
something to verify.
Ask about a company’s filed accounts, shareholders or corporate group. MCP gives a compatible assistant tools to retrieve the supporting records.
ChatGPTClaudeCursorOther MCP clients
Your MCP connection details.
Request the server URL, setup instructions and available tools for your account.
Connect, sign in and approve access. Your account permissions, usage allowance and workspace controls apply.
Request MCP setup instructions Company researchIllustrative workflow
Your question
“Review this UK supplier’s financial position and show me who owns it.”
- 01Identify the legal entity✓
kyb_search - 02Retrieve filed accounts✓
kyb_financial - 03Inspect the ownership✓
kyb_shareholders · kyb_group_structure
Evidence for your reviewCompany identified.
Company identified.
Financials and ownership in context.
Legal entityAccounts periodOwnership
Read the returned records, their dates and any missing information before drawing a conclusion.
Choose the route for the task.
REST: credit reports and monitoring. MCP: the published company, financial and ownership tools.
Search business credit reports
Look up a company before you integrate.
Select a country and enter the company’s legal name.
Free company preview. Full reports available on request.
Search by company number or VATEvaluate with your own company list
Start with the companies
you actually assess.
Validate the match, fields and source coverage against your workflow.
03 / Inside the API
The endpoints.
The job each one does.
Explore the documented routes for credit reports and the supporting company-data services.
From a company match to a structured report.
Search report availability, generate the report and retrieve its content. The report source ID and generated report ID have different roles.
↗
POST
/v2/credit-report/report/{format}Generate a report
Submit source_id and country. Keep the generated report ID and handle a pending result.
GET
/v2/credit-report/{id}/checkCheck readiness
Check whether a generated report is available before requesting the content.
GET
/v2/credit-report/report/{format}/{report_id}/fileRetrieve report content
Bring the report content into your own application or review process.
POST
/v2/credit-report/report/{format}/fileGenerate and retrieve
Use the combined route when your application can wait for report generation.
GET
/v2/credit-report/report/{format}/{report_id}Get a generated report
Retrieve a previously generated report by its report ID.
GET
/v2/credit-report/purchasedReview report history
List previously generated reports associated with your account.
Add the underlying company evidence.
Resolve the legal entity with KYB Search, then use its company ID for the registry endpoints. Request provenance where the endpoint supports it.
POST
/v2/kyb/searchResolve the legal entity
Start with country and legal name, registration number or VAT number.
GET
/v2/kyb/{id}/liteRead the company profile
Retrieve legal identity and registry information for the matched entity.
GET
/v2/kyb/{id}/financialRetrieve filed financials
Use available accounts, financial history and ratios in your analysis.
GET
/v2/kyb/{id}/officersCheck officers
Read available directors and officer information.
GET
/v2/kyb/{id}/shareholdersRead shareholders
Inspect the available share register for the company.
GET
/v2/kyb/{id}/group-structures/fullExplore the group
Map available parent and subsidiary relationships.
GET
/v2/kyb/{id}/uboInvestigate beneficial ownership
Review effective ownership, the selected threshold and whether the result is conclusive.
Keep the review connected to company changes.
Choose relevant fields, receive signed webhook notifications and retrieve event history. Confirm indicator coverage and source timing for your portfolio.
POST
/v2/companies/{id}/watch/startStart monitoring
Subscribe to available fields such as legal status, financials and officers.
GET
/v2/companies/{id}/watch/eventsRead company events
Retrieve the events for a monitored company.
PUT
/v2/companies/watch/callbackConfigure delivery
Set your callback URL and use the documented secret to verify webhook signatures.
DELETE
/v2/companies/{id}/watch/stopStop monitoring
Remove the company from the watch process when your scope changes.
Company evidence for your AI assistant.
Selected MCP tools relevant to company and financial review. Connect through your Business Credit Reports account; calls use your account’s permissions and usage allowance.
TOOL
kyb_searchIdentify the entity
Find the company in the relevant official registry.
TOOL
kyb_company_detailsRead the registry profile
Give your assistant company identity and legal-status context.
TOOL
kyb_financialInspect filed financials
Retrieve available financial statements to support analysis.
TOOL
kyb_shareholdersInspect shareholders
Read the available company share register.
TOOL
kyb_group_structureExplore the corporate group
Retrieve the available lite or full corporate structure.
Set API_BASE_URL to the endpoint supplied during onboarding. Endpoint reference checked 25 October 2026. Confirm your account access and target-market coverage before implementation. Open the current Request API documentation ↗
04 / From evaluation to integration
Build around
a clear data contract.
Agree the markets, records and usage first. Then connect the endpoints to your own application and policies.
Match the company.
Use country and legal identifiers. Keep KYB company IDs, credit-report source IDs and generated report IDs in their correct roles.
Handle the response.
Keep dates, currencies and missing fields. Support pending report generation, authentication errors and your agreed usage limits.
Put the data to work.
Connect reports to your credit process, company evidence to AI research, or supported events to your review queue.
REST / cURLDocumentation examples
Find report availability by country and registration number.
curl --get \
"${API_BASE_URL}/v2/credit-report" \
-H 'Authorization: Token YOUR_API_KEY' \
--data-urlencode 'country=GB' \
--data-urlencode 'registration_number=00445790'Use the source ID returned by the report search.
curl -X POST \
"${API_BASE_URL}/v2/credit-report/report/json" \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"source_id": "SOURCE_ID_FROM_SEARCH",
"country": "GB"
}'After the readiness check, request the generated content.
curl \
"${API_BASE_URL}/v2/credit-report/report/json/REPORT_ID/file" \
-H 'Authorization: Token YOUR_API_KEY'Run authenticated requests on your server.
Plan the commercial scope
Your markets. Your volume.
Your intended use.
Agree required fields, refresh arrangements, account limits and licensing. Discuss internal use, product integration and redistribution rights explicitly.
Request pricingAPI & MCP / FAQs
Before you
connect.
Practical answers for credit teams, procurement and engineering.
Request technical documentation ↗01What is a business credit reports API?
+
A business credit reports API lets your application request and retrieve company credit information. Business Credit Reports documents report search, generation, readiness checks, content retrieval and report history. Use the resulting information within your own onboarding, supplier-review or credit-management process.
02What information can a company credit report return?
+
Depending on the company and country, report content can include a credit score, recommended credit limit, financial statements, company identity, directors, ownership and public-record information. Report availability and individual fields must be confirmed for the entities you need. The product illustrations use an anonymised historical report; the workflow diagrams explain the integration.
03How do we find the correct legal entity?
+
Begin with the country and a legal name, registration number or VAT number. Use KYB Search for registry entity resolution and retain its company ID for KYB endpoints. The Credit Report API has a separate availability search that returns a report source ID. Confirm the registration details before requesting a report.
04Are business credit reports generated instantly?
+
Generation time depends on the company and country. The documentation describes both immediate and pending generation, with some reports taking up to three minutes. An integration should retain the generated report ID, handle pending results and check readiness rather than assume every request is immediately complete.
05Can we retrieve company financial statements separately?
+
Yes. The KYB financial endpoint provides available filed financial statements, while the Financials API also supports company financial data. Coverage, history and fields vary with local filing requirements. Keep the accounting period, currency and source context alongside the figures.
06What is the difference between the REST API and MCP?
+
REST gives developers explicit endpoints for reports, company data and monitoring. MCP lets a compatible assistant call the published company, KYB, financial and ownership tools. The MCP tools listed here support company research; credit-report generation and Watch Companies monitoring are documented separately in REST.
07Can we use Business Credit Reports data in ChatGPT or Claude?
+
Yes, through a compatible MCP connection. Add the Business Credit Reports MCP server and authenticate using the supported account connection. Your client’s capabilities, workspace controls and Business Credit Reports access determine the tools you can use. Follow the current setup documentation for your chosen client.
08Can the API monitor changes to customers and suppliers?
+
The Watch Companies API supports selected company fields, signed webhook notifications and event history. Agree which indicators are available for your portfolio and how your systems will handle delivery. Confirm score and credit-limit refresh separately; company-event monitoring does not establish universal score-alert coverage.
09Does global company coverage mean every company has financials and a credit score?
+
No. Company-record coverage, filed financials, credit reports and monitoring are different datasets. Business Credit Reports’ overall company intelligence covers 600 million companies across 200 countries, while available fields and reports vary. Validate your company list and required information before designing the integration.
10How do we request API, MCP or bulk-data access?
+
Use Contact Us to share your markets, company list, required fields, expected usage and intended use. Our team can confirm matching, data availability, access, refresh arrangements and licensing. Discuss internal use, product integration or redistribution explicitly so the agreement fits your workflow.
Put company intelligence to work
Bring the workflow.
We’ll help you connect the data.
Share your markets, company list and integration requirements.