Skip to content
RetrieveIQ Request beta access
How it works Product Developers Docs Coverage Security FAQ
Sign in Request beta access

Guides

A property tax bill API by parcel number

Published 17 November 2026 · California

A property tax bill API returns the bill itself for a parcel: each installment, its due date and delinquency date, what has been paid, and the charges by agency. That is different from a property data API, which typically returns assessor records and a single annual tax amount. RetrieveIQ offers a bill API for California parcels.

Bill data and property data are different things

Property data APIs are built on assessor records. They typically answer with the owner, the assessed value and one tax figure for the year. That is the right data for valuation and screening.

Paying, accruing or auditing needs the bill:

  • each installment, with its due date and the date it becomes delinquent
  • what the county shows as paid, and whether the county publishes payments at all
  • every charge on the bill and the agency that levied it
  • a corrected bill as its own revision, so the one it replaced stops counting
  • the document the figures came from

What a query looks like

RetrieveIQ’s API is GraphQL. This returns a parcel’s six newest bills with their installments, checks and charges:

query ($id: ID!) {
  parcel(id: $id) {
    parcelNumber
    bills(last: 6) {
      assessmentYear
      payableYear
      billType
      totalBilled
      withheld
      withheldReason
      installments { installmentNo dueDate delinquentAfter amountDue amountPaid paymentKnown status }
      validations { code severity message expected observed }
      charges { description amount levyingAgency }
      sourceDocument { filename contentPath }
    }
  }
}

Three fields are worth knowing before you build on it:

  • withheld is true when a check has not passed. The figures are shown and left out of every total until a person resolves the check.
  • paymentKnown is false when the county publishes no payment information. That is not the same as nothing paid.
  • sourceDocument is the county record the bill was drawn from, which you can download with the same key.

Loading parcels

Parcels are added one at a time or as a spreadsheet, up to 500 rows a call, with a dry run that checks every row and writes nothing. In California, naming the county is enough to place a parcel. A new parcel’s bills arrive within minutes, and each parcel’s figures are verified as current at least once a week.

Other ways in

  • AI assistants: an MCP server gives Claude and other assistants the same data, read-only. See AI assistants.
  • Files: a nightly CSV and Excel file to your SFTP server or storage bucket. See Keeping in sync.
  • Command line: the same records from a terminal. See Developers.

Limits

Coverage today is California. During the beta each firm is onboarded by hand before it can create an API key, so this is not a key you can create in a minute. Figures are verified on a schedule, so the API answers with the latest verified figures, not a live call to the county.

The full reference is in the documentation, and Common tasks walks through loading a portfolio and querying its bills.

Related guides

  • How to automate property tax bill retrieval
  • County record or OCR: two ways to capture a tax bill

Try it on your own parcels

RetrieveIQ is free during the California beta. Send a list of parcel numbers and see which bills come back, what each check found, and the county record behind every figure. Request beta access, or read how it works first.

RetrieveIQ © 2026 RetrieveIQ
Guides Security Privacy Terms [email protected] Sign in