# Kaisha Japan Company Registry — Corporate Events Feed

> Kaisha Japan Company Registry — Corporate Events Feed is a paid API for AI agents from kaisha-api.hp-vladic.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a paginated feed of recent Japanese company registry events (new incorporations, renames, closures, mergers, relocations) filtered by type, entity kind, prefecture, and date range

## Facts

- Endpoint: GET https://kaisha-api.hp-vladic.workers.dev/companies/events
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kaisha-japan-company-registry-corporate-events-feed-749006f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zdj_1TuVaWatJ7DDDc7N_

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 kaisha-japan-company-registry-corporate-events-feed-749006f8
```

Example prompt: Show me all newly registered 株式会社 companies in 東京都 from the past 14 days — up to 100 results please.

## When to prefer this

Choose this endpoint when you need a real-time feed of Japanese corporate registry events — new incorporations, closures, mergers, relocations, or renames — filterable by prefecture, entity type, and date range, without needing a corporate number or company name upfront. Prefer this over the name/number lookup endpoints when doing market monitoring, lead generation from new incorporations, compliance screening for entity changes, or building alerts on registry activity. It is the only x402-payable corporate events feed sourced directly from NTA data, requiring no API key setup.

## Known failure modes

- Payment not received / x402 challenge not completed — request blocked before data is returned
- Invalid date format for from/to parameters — malformed query
- days parameter out of 1-60 range — rejected with validation error
- Invalid kind code supplied — no matching entity type returns empty results
- Prefecture string not matching NTA canonical names — filter returns zero results
- NTA dataset temporarily stale — dataThrough may lag real-time by 1-2 days
- Offset beyond available results — returns empty events array

## How this service works

Official-data lookups for Japanese companies, priced per call via x402 (USDC on Base & Solana). Includes the only Japan qualified-invoice (適格請求書) registration-number verification on x402 — checked against the National Tax Agency dataset. Also: resolve company names / 13-digit corporate numbers to registry records, and compute Japanese business days & national holidays. No API keys — pay per request with x402.

## Output

A JSON object containing the event type queried, total count, date range covered, a data-through date reflecting the latest NTA dataset update, and an array of matching events — each with the 13-digit corporate number, company name in Japanese, event description in Japanese and English, entity kind (ja/en), event date, assignment date, and address (prefecture, city, postcode).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "to": {
       "type": "string",
       "description": "Explicit range end YYYY-MM-DD"
      },
      "days": {
       "type": "number",
       "description": "Lookback window in days (1-60, default 7)"
      },
      "from": {
       "type": "string",
       "description": "Explicit range start YYYY-MM-DD"
      },
      "kind": {
       "type": "number",
       "description": "Entity kind code (301=株式会社, 305=合同会社...)"
      },
      "type": {
       "type": "string",
       "description": "new | renamed | moved | closed | merged | all (default new)"
      },
      "limit": {
       "type": "number",
       "description": "Max results (default 50, max 200)"
      },
      "offset": {
       "type": "number",
       "description": "Paging offset"
      },
      "prefecture": {
       "type": "string",
       "description": "Filter by prefecture, e.g. 東京都"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "new",
  "count": 1,
  "range": {
   "to": "2026-07-17",
   "from": "2026-07-11"
  },
  "events": [
   {
    "kind": {
     "en": "Kabushiki Kaisha (stock company)",
     "ja": "株式会社"
    },
    "name": "株式会社サンプル",
    "event": {
     "en": "newly registered",
     "ja": "新設"
    },
    "address": {
     "city": "渋谷区",
     "postCode": "1500001",
     "prefecture": "東京都"
    },
    "eventDate": "2026-07-17",
    "assignmentDate": "2026-07-16",
    "corporateNumber": "1010001234567"
   }
  ],
  "dataThrough": "2026-07-17"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kaisha-japan-company-registry-corporate-events-feed-749006f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kaisha-api.hp-vladic.workers.dev](https://www.zero.xyz/host/kaisha-api.hp-vladic.workers.dev/llms.txt)