# Company Lookup & KYB Registry

> Company Lookup & KYB Registry is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-17).

Looks up company identity, legal status, LEI, financials, SEC filings, and FDIC bank data from official registers across UK, DK, NO, FR, FI, EE, NL, and US.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/company-check?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-lookup-kyb-registry-d0aef3e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P9l7aS6bM3O_lgcZbiFb-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability company-lookup-kyb-registry-d0aef3e1 -d '<json body>'
```

Example prompt: Can you look up Novo Nordisk in Denmark — I need their LEI, legal registration number, active status, registered address, and the last 3 years of revenue and net income from official sources?

## When to prefer this

Choose this endpoint when you need authoritative, official-source company data across multiple European countries and the US in a single call, especially for KYB compliance, supplier due diligence, or financial benchmarking. It is superior to general web search when you need structured legal identity fields (LEI, registration number, legal form, status) paired with XBRL-sourced financials and SEC filings. Prefer this over country-specific endpoints (like Company Accounts UK DK NO) when you need cross-country coverage or want identity plus financials plus SEC data in one response.

## Known failure modes

- Company not found in any official register — returns empty rows with not_found explanations and no charge
- Invalid country code or malformed query — validation error returned
- Company exists but has no financial filings — identity returned but financials section empty
- US section not applicable for non-US registrants — not_found reason provided in response
- Network or upstream register unavailability — error returned with no charge

## How this service works

Company lookup and KYB from official registers: name, LEI, number, status, address, financials, people, SEC and FDIC data. UK (with charges, Gazette insolvency), PL, DK, NO, FR, FI, EE, IE, CZ, LV, US. Typical call $0.03: $0.03 per company report, min $0.005. upto: pay only for delivered rows; exact: pays the quote. Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.

## Output

Returns a JSON object with rows containing: company identity fields (legal name, LEI, registration number, status, country, registered address, legal form, website), multi-year financials (revenue, net income, total assets, total equity, operating profit, cash, employees, currency, fiscal year dates), US-specific data (SEC/FDIC), source URLs per data point, warnings, not-found explanations for missing sections, query metadata (query type, duration, schema version), and billing info (charged USD, payment method).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "pattern": "^[^\\[\\]{}<>\\r\\n]*$",
   "description": "The company to check: a name (e.g. \"Novo Nordisk\") or an identifier: LEI"
  },
  "country": {
   "type": "string",
   "pattern": "^\\s*([A-Za-z]{2})?\\s*$",
   "description": "ISO 3166 alpha-2 country code to disambiguate"
  },
  "include": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "default": [
    "identity",
    "financials",
    "us",
    "people"
   ],
   "description": "Which sections to fill: any of \"identity\", \"financials\", \"us\" (SEC filings of US issuers), \"people\""
  },
  "maxYears": {
   "type": "integer",
   "default": 3,
   "maximum": 10,
   "minimum": 1,
   "description": "How many fiscal years of key figures to return, newest first, e.g. 3"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "us": null,
    "query": "24256790",
    "country": "DK",
    "sources": [
     {
      "url": "https://filings.xbrl.org/549300DAQ1CVT6CXN342/2025-12-31/ESEF/DK/0/NOVO-2025-...",
      "name": "filings.xbrl.org",
      "section": "financials"
     }
    ],
    "identity": {
     "lei": "549300DAQ1CVT6CXN342",
     "status": "active",
     "country": "DK",
     "website": null,
     "register": "Erhvervsstyrelsen (CVR)",
     "legal_form": "Aktieselskab",
     "legal_name": "NOVO NORDISK A/S",
     "lei_status": "ISSUED",
     "source_urls": {
      "legal_name": "https://api.gleif.org/api/v1/lei-records/549300DAQ1CVT6CXN342",
      "registered_address": "https://api.gleif.org/api/v1/lei-records/549300DAQ1CVT6CXN342"
     },
     "registered_address": "Novo Alle 1, 2880 Bagsværd, DK",
     "registration_number": "24256790"
    },
    "warnings": [],
    "not_found": [
     {
      "reason": "Not a US SEC registrant (no US ticker or CIK, and GLEIF does not list it as a...",
      "section": "us"
     }
    ],
    "candidates": [],
    "financials": {
     "basis": "Consolidated annual report of a listed company (ESEF, IFRS figures).",
     "years": [
      {
       "revenue": 309064000000,
       "concepts": {
        "revenue": "ifrs-full:Revenue",
        "net_income": "ifrs-full:ProfitLoss"
       },
       "currency": "DKK",
       "employees": null,
       "net_income": 102434000000,
       "period_end": "2025-12-31",
       "report_url": "https://filings.xbrl.org/549300DAQ1CVT6CXN342/2025-12-31/ESEF/DK/0/NOVO-2025-...",
       "source_url": "https://filings.xbrl.org/549300DAQ1CVT6CXN342/2025-12-31/ESEF/DK/0/NOVO-2025-...",
       "total_assets": 542902000000,
       "total_equity": 194047000000,
       "operating_profit": 127658000000,
       "fiscal_year_start": "2025-01-01",
       "cash_and_equivalents": 26464000000
      }
     ],
     "source": "filings.xbrl.org"
    },
    "query_type": "cvr",
    "retrieved_at": "2026-11-05T20:50:37+00:00",
    "schema_version": "1",
    "duration_seconds": 2
   }
  ],
  "tool": "company-check",
  "count": 1,
  "message": "",
  "paid_via": "x402",
  "warnings": [],
  "balance_usd": 0,
  "charged_usd": 0.03,
  "duration_seconds": 1.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-lookup-kyb-registry-d0aef3e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
