Company data API.
Records you can trace.

# Run server-side with your live API key.
# 1. Search using the company's registration number.
curl --fail-with-body --request POST \
  'https://companyproof.ai/v2/companies/search' \
  --header "Authorization: Bearer $COMPANYPROOF_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "identifier_type": "registration_number",
    "identifier": "09410808",
    "country": "GB"
  }'
 
# 2. Confirm the match, then set the returned ID.
# Replace the placeholder with companies[n].id.
COMPANY_ID='REPLACE_WITH_RETURNED_COMPANY_ID'
 
curl --fail-with-body \
  "https://companyproof.ai/v2/companies/$COMPANY_ID/profile" \
  --header "Authorization: Bearer $COMPANYPROOF_API_KEY"

// Node.js / server-side. Keep the live key private.
const base = "https://companyproof.ai/v2";
const headers = {
  Authorization: "Bearer " + process.env.COMPANYPROOF_API_KEY,
  "Content-Type": "application/json"
};
 
const search = await fetch(base + "/companies/search", {
  method: "POST", headers,
  body: JSON.stringify({
    identifier_type: "registration_number",
    identifier: "09410808", country: "GB"
  })
});
if (!search.ok) throw new Error(await search.text());
const { companies } = await search.json();
const match = companies.find(c =>
  c.registration_number === "09410808" && c.country === "GB"
);
if (!match) throw new Error("No exact company match");
 
const response = await fetch(
  base + "/companies/" + encodeURIComponent(match.id) + "/profile",
  { headers }
);
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
// Check section_status and errors inside each profile module.
console.log(result.section_status, result.profile);

# Python standard library. Run server-side.
import json
import os
from urllib.request import Request, urlopen
from urllib.parse import quote
 
base = "https://companyproof.ai/v2"
headers = {
    "Authorization": "Bearer " + os.environ["COMPANYPROOF_API_KEY"],
    "Content-Type": "application/json"
}
 
def request(path, data=None):
    body = json.dumps(data).encode() if data is not None else None
    with urlopen(Request(base + path, data=body, headers=headers),
                 timeout=60) as response:
        return json.load(response)
 
search = request("/companies/search", {
    "identifier_type": "registration_number",
    "identifier": "09410808", "country": "GB"
})
match = next((c for c in search["companies"]
              if c.get("registration_number") == "09410808"
              and c.get("country") == "GB"), None)
if match is None:
    raise ValueError("No exact company match")
 
result = request("/companies/" + quote(match["id"], safe="") + "/profile")
# Check section_status and errors inside each profile module.
print(result["section_status"], result["profile"])

{
  "company_id": "company_123",
  "profile": {
    "lite": {
      "basic": {
        "name": "ACME HOLDINGS LIMITED",
        "status": "Active",
        "source": {
          "name": "Illustrative company registry",
          "retrieved_at": "2026-08-29T10:42:11.000Z"
        }
      }
    },
    "shareholders": {
      "error": {
        "status_code": 403,
        "message": "This module is unavailable for the selected record."
      }
    }
  },
  "enrichment": null,
  "section_status": {
    "profile": "available",
    "enrichment": "unavailable"
  }
}