---
name: denpyo-api.hp-vladic.workers.dev
description: This host provides a single API endpoint that looks up Japanese qualified invoice issuer registration numbers (T + 13 digits) against the national tax authority registry. It returns registration validity, active or cancelled status, registered business name, corporate details, and an optional fuzzy name-match verdict for supplier verification.
host: denpyo-api.hp-vladic.workers.dev
---

# denpyo-api.hp-vladic.workers.dev

denpyo-api.hp-vladic.workers.dev is a narrow-purpose registry lookup service targeting agents and systems that process Japanese invoices under the qualified invoice system (インボイス制度). It serves accounts-payable automation, tax compliance workflows, and supplier onboarding pipelines that need to confirm a registration number is real, active, and associated with the correct legal entity name. It does not perform document parsing or OCR; it assumes the registration number is already known.

## When to use this host

Use this host when an agent has a Japanese invoice registration number (T + 13 digits) and needs to confirm it exists in the national registry, is currently active, and optionally matches a given supplier name. Do not use it for extracting registration numbers from invoice images or PDFs — a separate OCR or document-parsing service is required upstream for that. Do not use it for non-Japanese tax ID validation (e.g., EU VAT numbers, US EINs); those require different registry services. If the registration number is not yet known, this host cannot help — resolve the number first through document extraction tooling before calling this endpoint.

## Capabilities

### Japan Invoice Registry Lookup

Validates a Japanese qualified invoice registration number against the national registry, returning format validity, checksum correctness, registration status (active or cancelled), registered entity details, and an optional fuzzy match between a supplied supplier name and the registered name.

- **`verify-japan-invoice-registration`** — Looks up a Japan qualified-invoice-issuer registration number (T + 13 digits) in the national registry and returns existence, active/cancelled status, registered name, corporate details, and an optional fuzzy name-match verdict.

## Skill reference

### `verify-japan-invoice-registration`

**PayVerify – Japan Qualified Invoice Registration Check** — Looks up a Japan qualified-invoice-issuer registration number (T + 13 digits) in the national registry and returns existence, active/cancelled status, registered name, corporate details, and an optional fuzzy name-match verdict.

*Use when:* Use when an agent needs to confirm whether a Japanese invoice registration number is valid and active, or needs to verify that a supplier name on an invoice matches the name registered with the Japanese tax authority.

*Not for:* Do not use for OCR extraction of invoice data from images or PDFs; this endpoint only performs registry lookups against a known registration number.

**Inputs:**

- `number` (string, required) — Japan qualified-invoice registration number (T followed by 13 digits). The leading T is optional.
- `name` (string) — Issuer name to fuzzy-match against the registered name in the registry. When provided, the response includes a nameMatch verdict.

**Returns:** Returns a JSON object with formatValid, checksumValid, verdict ('qualified'), registered status, registeredName, nameMatch boolean, corporate address details, and the registry snapshot date used for the check.

**Example:** `GET https://denpyo-api.hp-vladic.workers.dev/verify?number=T1180301018771&name=%E3%83%88%E3%83%A8%E3%82%BF%E8%87%AA%E5%8B%95%E8%BB%8A`

---