Government
National Tax Agency Japan (国税庁) — Tax Circulars logo

National Tax Agency Japan (国税庁) — Tax Circulars API

nta.go.jp

国税庁 法令解釈通達 (e.g. 所得税基本通達): table of contents with hierarchy, item text, notes and amendment history.

Actions
3
Category
Government
Login
Not required
Output
JSON

Call the National Tax Agency Japan (国税庁) — Tax Circulars API

Submit a task, then poll the job until it settles. This example runs nta_tsutatsu_document.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "nta_tsutatsu_document",
    "params": {
      "toc_url": "https://www.nta.go.jp/law/tsutatsu/kihon/shotoku/01.htm",
      "offset": 0
    }
  }'

3 actions on nta.go.jp

Read

  • Tax Circular Full Text

    nta_tsutatsu_documentread2 credits / call

    Get a whole 国税庁 通達 in table-of-contents order, up to 25 pages per call: every page's items as in Tax Circular Page, the TOC entries that point to it, and a coverage report (expected, retrieved and failed pages). Use next_offset for the next batch.

    toc_url
    string
    offset
    integer
    limit
    integer
  • Tax Circular Page

    nta_tsutatsu_sectionread2 credits / call

    Get one text page of a 国税庁 通達 as ordered items: item number (e.g. 28-1), heading, topic and anchor, main text, amendment history, sub-paragraphs with indent level, (注) notes, and a content hash per item and per page.

    url
    string · required
  • Tax Circular Table of Contents

    nta_tsutatsu_tocread2 credits / call

    Get the full table of contents of a 国税庁 法令解釈通達 (e.g. 所得税基本通達) in order: 編, 章, 節, 法第X条 関係 and 〔topic〕 entries with their level, parent path and page link, plus the list of distinct text pages and a content hash.

    toc_url
    string

National Tax Agency Japan (国税庁) — Tax Circulars API questions

Is there an API for National Tax Agency Japan (国税庁) — Tax Circulars?
National Tax Agency Japan (国税庁) — Tax Circulars does not offer a public data API for this, but Anakin Wire provides 3 maintained endpoints for nta.go.jp. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape National Tax Agency Japan (国税庁) — Tax Circulars data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when nta.go.jp changes its markup, Anakin updates the action.
Do I need a National Tax Agency Japan (国税庁) — Tax Circulars account?
No. Every National Tax Agency Japan (国税庁) — Tax Circulars action listed here runs anonymously — no account and no credentials required.
What does the National Tax Agency Japan (国税庁) — Tax Circulars API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Government APIs

All Government sites