# Zinin Company Registry Enricher

> Zinin Company Registry Enricher is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Looks up a company by name and returns its LEI, legal status, jurisdiction, registered address, and registry metadata

## Facts

- Endpoint: POST https://api.timzinin.com/api/company-registry-enricher?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zinin-company-registry-enricher-740c8bbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x8U8vDdGGnxMVTaz1tbRA

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 zinin-company-registry-enricher-740c8bbd -d '<json body>'
```

Example prompt: Look up Apple Inc. in the company registry and get me its LEI, legal status, jurisdiction, and registered address so I can verify it's an active entity.

## When to prefer this

Use this endpoint when you need to resolve a company name to a verified legal entity record including LEI, jurisdiction, and registration status — particularly for KYB/compliance workflows, financial regulatory reporting, or enriching CRM/vendor records with official registry data. Prefer this over generic business search APIs when you specifically need LEI codes or cross-border legal entity verification with match confidence scoring.

## Known failure modes

- Company name not found in registry — found:false with empty candidates list
- Low match confidence — partial name match returns candidates with similarity below threshold
- Ambiguous company name — multiple candidates returned requiring disambiguation
- Registry unavailable — upstream GLEIF or national registry timeout causing elevated run_ms
- Invalid request body — missing or malformed company name input

## How this service works

Pay-per-call data & tool APIs

## Output

A JSON object containing the matched company's LEI, legal name, match basis and confidence score (0–1), jurisdiction (e.g. US-CA), registration status (ACTIVE/INACTIVE), legal form code, registered address, SIC codes, directors list, UK company number if applicable, and run metadata including execution time in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "companies": {
   "type": "array",
   "maxItems": 100
  },
  "maxConcurrency": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "companiesHouseApiKey": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "found": true,
    "input": "Apple Inc.",
    "status": "ACTIVE",
    "summary": "Apple Inc. — US-CA entity, LEI HWUPKR0MPOU8FGXBT394, status ACTIVE. Matched \"Apple Inc.\" to \"Apple Inc.\" by name, similarity 1.00.",
    "sicCodes": [],
    "checkedAt": "2026-07-26T13:57:28.237Z",
    "directors": [],
    "legalForm": "H1UM",
    "legalName": "Apple Inc.",
    "candidates": [],
    "matchBasis": "name",
    "jurisdiction": "US-CA",
    "matchConfidence": 1,
    "ukCompanyNumber": null,
    "registeredAddress": "C/O C T Corporation System, 330 N. Brand Blvd, Suite 700, Glendale, US-CA, US, 91203",
    "registrationStatus": "ISSUED"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zinin-company-registry-enricher-740c8bbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)