# Johto Data API – Japan Invoice Registration Check

> Johto Data API – Japan Invoice Registration Check is a paid API for AI agents from johto-x402-api.johtodata.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-28).

Looks up a Japanese consumption tax invoice registration number (T + 13 digits) against Japan's NTA invoice publication system and returns entity name, registration status, prefecture, and key dates.

## Facts

- Endpoint: GET https://johto-x402-api.johtodata.workers.dev/v1/jp-invoice-check?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/johto-data-api-japan-invoice-registration-check-5f63f392
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vznUWvmzFDGqsQP6L78Z9

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 johto-data-api-japan-invoice-registration-check-5f63f392
```

Example prompt: Can you check if Japanese invoice registration number T1010102010845 is currently valid — I need the entity name, status, and prefecture?

## When to prefer this

Choose this endpoint when you need to validate or enrich data about a Japanese entity using its consumption tax invoice registration number (T-number). It is the right choice for accounts payable automation, supplier onboarding, or compliance workflows involving Japanese businesses. It sources directly from the authoritative NTA invoice publication system and is pay-per-successful-call, making it cost-efficient for both bulk and one-off lookups.

## Known failure modes

- Invalid registration number format (must match T + exactly 13 digits) — request rejected before payment
- No matching record found — empty data array returned, no charge applied
- NTA source system unavailable — fetch fails, no charge applied
- Payment failure via x402 — request not processed

## How this service works

Valuable data. Quality leads. Paid per call in USDC on Base via x402. Not charged if the fetch fails or nothing matches. Prices per call (USDC): /v1/jp-invoice-check $0.002; /v1/sec-13f $0.003; /v1/sec-8k $0.003; /v1/sanctions-screen $0.0025; /v1/tenders $0.011; /v1/uk-tenders $0.003; /v1/fr-tenders $0.006; /v1/au-contracts $0.0035; /v1/wallet-risk $0.0025; /v1/kyb $0.0029; /v1/read $0.0019; /v1/crawl $0.0045; /v1/jobs $0.01; /v1/domain-profile $0.003.

## Output

A JSON object containing an array of matched records (data) and a row count. Each record includes the entity's Japanese name, registration number, status (registered or expired), prefecture, registration date, last update date, optional expiry date, data freshness date, and the NTA source URL. Returns an empty array with rows: 0 if no match is found; no charge is applied for failed or empty fetches.

## 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": [
      "t"
     ],
     "properties": {
      "t": {
       "type": "string",
       "pattern": "^[Tt][0-9]{13}$",
       "description": "Registration number, T + 13 digits"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "rows"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         },
         "source": {
          "type": "string"
         },
         "status": {
          "type": "string"
         },
         "data_as_of": {
          "type": "string"
         },
         "prefecture": {
          "type": "string"
         },
         "expire_date": {
          "type": "string"
         },
         "update_date": {
          "type": "string"
         },
         "registration_date": {
          "type": "string"
         },
         "registration_number": {
          "type": "string"
         }
        }
       }
      },
      "rows": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "name": "リベージュインターナショナル有限会社",
    "source": "https://www.invoice-kohyo.nta.go.jp/",
    "status": "registered",
    "data_as_of": "2026-10-21",
    "prefecture": "東京都",
    "update_date": "2023-01-25",
    "registration_date": "2023-10-01",
    "registration_number": "T1010102010845"
   },
   {
    "name": "霊源寺",
    "source": "https://www.invoice-kohyo.nta.go.jp/",
    "status": "expired",
    "data_as_of": "2026-10-21",
    "prefecture": "東京都",
    "expire_date": "2025-04-01",
    "update_date": "2025-03-27",
    "registration_date": "2023-10-01",
    "registration_number": "T1010705000243"
   },
   {
    "name": "特定非営利活動法人Ｑｕａｌｉｔｙ　Ｓｐｏｒｔｓ　Ｌｉｆｅ",
    "source": "https://www.invoice-kohyo.nta.go.jp/",
    "status": "expired",
    "data_as_of": "2026-10-21",
    "prefecture": "東京都",
    "expire_date": "2025-07-01",
    "update_date": "2025-07-18",
    "registration_date": "2023-10-01",
    "registration_number": "T1011705001685"
   }
  ],
  "rows": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/johto-data-api-japan-invoice-registration-check-5f63f392/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from johto-x402-api.johtodata.workers.dev](https://www.zero.xyz/host/johto-x402-api.johtodata.workers.dev/llms.txt)