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:
withheldis true when a check has not passed. The figures are shown and left out of every total until a person resolves the check.paymentKnownis false when the county publishes no payment information. That is not the same as nothing paid.sourceDocumentis 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
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.