referencesource.org

What reference datasets are available? Lists every published dataset with its title, record count, last-verified date and a one-sentence summary. Covers regulatory thresholds, version compatibility, certification registers, licensing rules and more. Pass `query` to list only the datasets matching a topic — that is much cheaper than reading the whole list. Use the returned slug with search_records or get_record.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional topic filter, e.g. \"boiler\", \"tariff\" or \"loan limit\". Case-insensitive substring, matched against each dataset's slug, title and full description. Omit it to list every dataset."
    },
    "full": {
      "type": "boolean",
      "description": "Return each dataset's complete scope statement instead of the first sentence. Off by default: the full text is roughly four times the size and is rarely needed to choose a dataset."
    }
  }
}

Look up a specific record — search by state name, chemical, certificate number, product name or any keyword. Searches one dataset's records (case-insensitive substring match across all fields). Returns up to 20 matching records, each with its url, source and verbatim source_quote so the answer can be checked.

{
  "type": "object",
  "properties": {
    "dataset_slug": {
      "type": "string",
      "description": "Dataset slug from list_datasets, e.g. \"graduated-driver-licensing\"."
    },
    "query": {
      "type": "string",
      "description": "Substring to match, case-insensitive, e.g. a state code, chemical name or standard number."
    }
  },
  "required": [
    "dataset_slug",
    "query"
  ]
}

Fetch one record by id — for example, look up a FIPS 140 certificate's status, a state's boiler inspection rules, or a county's loan limit. Returns the full record with its source URL and verbatim source quote. Record ids appear in search_records results and in each record's url.

{
  "type": "object",
  "properties": {
    "dataset_slug": {
      "type": "string",
      "description": "Dataset slug from list_datasets."
    },
    "record_id": {
      "type": "string",
      "description": "The record's id field, e.g. \"ak\"."
    }
  },
  "required": [
    "dataset_slug",
    "record_id"
  ]
}

Is this value actually right? Check a claimed fact against a published record instead of trusting it. Reports whether the claim matches the record's stored value (exact, case-insensitive or normalised — the match type is named), whether it appears in the record's verbatim source quote, and returns the source URL and quote so the claim can be traced upstream. Use this whenever you want to confirm a number, date, threshold or status before stating it. Verdicts: matches_record, matches_quote, differs or not_found.

{
  "type": "object",
  "properties": {
    "dataset_slug": {
      "type": "string",
      "description": "Dataset slug from list_datasets."
    },
    "claimed_value": {
      "type": "string",
      "description": "The value to check, exactly as claimed, e.g. \"$832,750\" or \"no passengers younger than 21\"."
    },
    "record_id": {
      "type": "string",
      "description": "The record's id, if known (shown in search_records results and in each record's url). Without it, the dataset's stored values are searched for the claimed value."
    },
    "field": {
      "type": "string",
      "description": "Field name to check the claim against, e.g. \"limit_1_unit\". Without it, every stored field is checked."
    }
  },
  "required": [
    "dataset_slug",
    "claimed_value"
  ]
}