---
updatedAt: 2025-11-13T21:49:09.000Z
agentTools:
  projectIndex: https://docs.sikoia.com/llms.txt
---

# Access Company Credit Report

```curl cURL
curl --request POST \
     --url https://api.sikoia.com/v2/cases \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <<bearer_token>>' \
     --data '
{
     "name": "Company Registry Recipe",
     "case_type": "Business"
}
'

curl --request POST \
     --url https://api.sikoia.com/v2/cases/039a67a3-b996-4376-95b6-f0b8f9c2fb71/entities \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <<bearer_token>>' \
     --data '
{
     "companies": [
          {
               "company_name": "Test Company",
               "company_number": "12345678",
               "jurisdiction_code": "GB"
          }
     ]
}
'

curl --request POST \
     --url https://api.sikoia.com/v2/company-credit-reports \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <<bearer_token>>' \
     --data '
{
  "company_id": "0c97d69b-44f3-4336-b26f-d77edb5176c6"
}
'

curl --request GET \
     --url https://api.sikoia.com/v2/company-credit-reports/54aeee45-b8da-455d-a736-e125dfc0f9a2 \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer <<bearer_token>>'

curl --request POST \
     --url https://api.sikoia.com/v2/company-credit-reports \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <<bearer_token>>' \
     --data '
{
  "company_id": "0c97d69b-44f3-4336-b26f-d77edb5176c6"
}
'

```

# Create an Empty Case

<!-- curl@1-11 -->

Create a case. We will use this to add companies that we want to get data for.

# Add a Company to the Case

<!-- curl@13-28 -->

Using the `case_id` from Step 1, add a new company by sending the company details.
These will be the details submitted to you by your applicant.

This endpoint supports adding multiple companies and people in one call.

# Request Company Credit Report

<!-- curl@30-39 -->

Make a credit report request using the `company_id` generated in Step 2.

# Get Company Credit Report

<!-- curl@41-44 -->

Using the `request_id` returned by Step 3, retrieve the company credit report.

If the status is "TooManyResults", then we have not been able to get an exact match.  This can be resolved using the picklist endpoint. See the Handle Company Credit Report Picklists recipe for more information on how to resolve a picklist.

# Refresh Credit Report data

<!-- curl@46-55 -->

To get the latest credit report data you can refresh it by simply making the same call as in Step 3.