LawDiver for Tax API

Tax authorities over REST

Dedicated endpoints — not a flag on caselaw search. Create a regular LawDiver account, mint an ld_tax_ key, and call /api/v1/tax/*.

Authentication

Send your Tax key as Authorization: Bearer ld_tax_…, X-API-Key, or lawdiver_api_key. Caselaw ld_live_ keys are rejected on this surface. The free web product at /tax needs no key.

Quick start

  1. 1

    Sign up

    Same accounts as the rest of LawDiver.

  2. 2

    Create a Tax API key

    Account → API Keys → Tax API (prefix ld_tax_).

  3. 3

    POST JSON

    Base URL https://lawdiver.com. See endpoints below and github.com/lawdiver/LawDiver-tax-api.

Endpoints

All methods are POST with a JSON body. Responses use the standard LawDiver /api/v1 envelope.

Search

POST /api/v1/tax/search — Query across IRC, Treas. regs, IRS guidance, written determinations, forms/pubs, treaties, and IRM.

Law (IRC / Treas. Reg.)

POST /api/v1/tax/law — Fetch a Code or regulation section as of a year, optionally redline against another year.

IRS guidance

POST /api/v1/tax/guidance — Resolve a Rev. Rul., Rev. Proc., notice, PLR, or other guidance cite with status and optional cited-by.

Check cites

POST /api/v1/tax/check — Verify up to 50 tax authority cites in one call — existence, adverse status, judicial notes.

Case ↔ IRS context

POST /api/v1/tax/case-context — IRS authorities tied to a Tax Court or other opinion id.

Treaty

POST /api/v1/tax/treaty — U.S. income-tax treaty articles by country, topic, or article, as of a date.

Form / instructions / pub

POST /api/v1/tax/form — IRS form or instruction revision by number and optional tax year.

What's new

POST /api/v1/tax/whats-new — Guidance and forms published since a date, optionally filtered by Code sections.

POST /api/v1/tax/search

Query across IRC, Treas. regs, IRS guidance, written determinations, forms/pubs, treaties, and IRM.

{
  "query": "qualified business income",
  "sources": ["irc", "guidance"],
  "codeSection": "199A",
  "limit": 10
}

POST /api/v1/tax/law

Fetch a Code or regulation section as of a year, optionally redline against another year.

{
  "kind": "irc",
  "cite": "163",
  "asOf": 2018,
  "compareTo": 2016,
  "includeText": true
}

POST /api/v1/tax/guidance

Resolve a Rev. Rul., Rev. Proc., notice, PLR, or other guidance cite with status and optional cited-by.

{
  "cite": "Rev. Rul. 99-7",
  "includeText": true,
  "includeCitedBy": true
}

POST /api/v1/tax/check

Verify up to 50 tax authority cites in one call — existence, adverse status, judicial notes.

{
  "cites": ["I.R.C. § 61", "Treas. Reg. § 1.61-1", "Rev. Rul. 99-7"]
}

POST /api/v1/tax/case-context

IRS authorities tied to a Tax Court or other opinion id.

{
  "opinionId": 12345678
}

POST /api/v1/tax/treaty

U.S. income-tax treaty articles by country, topic, or article, as of a date.

{
  "country": "Germany",
  "topic": "dividends",
  "asOf": "2024-01-01"
}

POST /api/v1/tax/form

IRS form or instruction revision by number and optional tax year.

{
  "number": "1065",
  "part": "form",
  "taxYear": 2024,
  "includeText": true
}

POST /api/v1/tax/whats-new

Guidance and forms published since a date, optionally filtered by Code sections.

{
  "since": "2026-01-01",
  "codeSections": ["163"],
  "limit": 50
}

curl example

curl -s https://lawdiver.com/api/v1/tax/law \
  -H "Authorization: Bearer ld_tax_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"irc","cite":"61","asOf":2024,"includeText":true}'

TypeScript example

const res = await fetch('https://lawdiver.com/api/v1/tax/guidance', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LAWDIVER_TAX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ cite: 'Rev. Rul. 99-7', includeText: true }),
});
const json = await res.json();

Python example

import os, requests
r = requests.post(
    "https://lawdiver.com/api/v1/tax/check",
    headers={"Authorization": f"Bearer {os.environ['LAWDIVER_TAX_API_KEY']}"},
    json={"cites": ["I.R.C. § 61", "Rev. Rul. 99-7"]},
)
print(r.json())

GitHub

Integration starter and SEO-friendly docs: https://github.com/lawdiver/LawDiver-tax-api. Free web: LawDiver for Tax.