Contribute data

Small, focused data additions are perfect — one tax at a time.

Start with your local jurisdiction

Pick your city or county first. Find one tax with an official source and add it as a small JSON file via Pull Request or Issue. Get in touch if you'd like some help.

Copy this research prompt

  Goal: add one or more taxes for my local jurisdiction to taxtracker.org as structured JSON.

  Jurisdiction:
  - Level: [federal, state, city, county, special district]
  - Name: [e.g., California or Vacaville or Solano County]
  - Slug: [lowercase-with-dashes, e.g., vacaville]

  What to find (from official sources):
  1) Tax name & purpose (e.g., Sales and Use Tax; Lodging/Transient Occupancy; Business License).
  2) Status (active, proposed, repealed) and the most recent updated/ballot/ordinance date.
  3) Administering agency (department name).
  4) Rate — percent or amount (flat), note what it applies to.
  5) At least one authoritative source URL (statute/ordinance, ballot measure, agency page, revenue office, state admin).
  6) Optional notes (earmarks, funds, thresholds).

  Where to look:
  - City/County code (the city's website and municipal ordinance section).
  - Finance/Revenue/Treasurer department pages.
  - Ballot portals / clerk-recorder notices.
  - For state-administered local taxes: state tax admin pages (e.g., CDTFA for CA).

  Deliverable (JSON keys alphabetically sorted):
  {
    "agency": { "name": "Dept. of Revenue", "slug": "dept-revenue" },
    "effective": { "start": "YYYY-MM-DD", "end": null },
    "id": "<jurisdiction-slug>-<tax-slug>",
    "jurisdiction": { "level": "city", "name": "Vacaville", "slug": "vacaville" },
    "name": "Sales and Use Tax",
    "notes": "",
    "rates": [ { "applies_to": "taxable sales", "cap": null, "kind": "percent", "value": 3.00 } ],
    "slug": "sales-and-use-tax",
    "sources": [ { "name": "Municipal code", "url": "https://…" } ],
    "status": "active",
    "type": "sales",
    "updated_at": "YYYY-MM-DD"
  }

Suggest via GitHub Issue Add JSON via Pull Request

We auto-sort keys and validate JSON in CI. Small, accurate contributions are best.