Records and citations - Quoin Data

A record is one row from a publisher’s dataset: a sale, a permit, a tax bill, an assessment. The API returns it as the publisher wrote it, with a citation.

{
  "record_ref": "rec_b89a441a-7f83-c175-9f7e-b73dd7adc30a",
  "kind": "account",
  "source_id": "itspe_current",
  "jurisdiction": "11001",
  "published_at": "2026-10-08T11:41:03.315Z",
  "citation": {
    "source": "DC Office of Tax and Revenue",
    "dataset": "Integrated Tax System Property Extract",
    "as_of": "2026-10-08"
  },
  "data": { "ssl": "1301    0728", "square": "1301", "lot": "0728", "amtdue1": 6573.07 }
}

Field	Meaning
`record_ref`	Permanent record id. Every version of the record shares it
`kind`	Record type, for example `sale`, `permit`, `account`, `assessment`, `tax`, `building`
`source_id`	The source dataset. Look it up in `catalog`
`jurisdiction`	County code the record belongs to
`published_at`	When Quoin published this version
`citation`	Publisher, dataset and the date Quoin published the data
`data`	The full source row, with field names exactly as the publisher wrote them
`about`	On `records`: the entity the record is attached to
`q_ids`	On `search`: every entity the record is about

Field names and formats differ between publishers. A sale price might be PRICE in one county and sale_price in another. catalog lists each source’s fields.

Three ways to read records

Endpoint	Use it for
`summary`	One best value per canonical field across all sources: `year_built`, `bedrooms`, `full_baths`, `half_baths`, `living_area_sqft`, `assessed_total`, `last_sale_price`, `last_sale_date`. Each value carries its citation and up to 10 `alternatives` from other sources
`records`	Every current record about an entity and the entities linked to it, optionally one `kind` at a time
`search`	Records of one kind across a jurisdiction, filtered on source fields

Versions

When a publisher changes a record, Quoin publishes a new version under the same record_ref. history returns every version, newest first. removed: true means the publisher stopped carrying the record.

Citing data

Keep the citation with any value you show or store. Some publishers require attribution when you share their records. See Publisher notices.