# Know Your Mouth trial funding ledger — data files

`trials.json` (an array of objects) and `trials.csv` (the same rows, one per line) hold one record per human trial, systematic review, commentary or guideline cited on [knowyourmouth.com](https://knowyourmouth.com/), with the paper's funding statement and competing-interest declaration copied word for word. The rendered table is at <https://knowyourmouth.com/trial-funding-ledger.html>; each row's anchor is its `id` (for example `#P2023`).

Licence: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Reuse with credit to Know Your Mouth. The quoted statements remain the words of their authors and journals.

## The rule

Open the paper. Copy the funding statement and the competing-interest statement exactly as printed, in quotation marks. If a statement is not there, or cannot be read, use one of the literal phrases below. Record the URL where you read it and the date. Never paraphrase and never infer a funder from context; the only inference the schema allows is an author's employer as shown on PubMed, and that is recorded separately with its own basis label.

## Fields, in order

| Field | Type | Meaning and allowed values |
|---|---|---|
| `id` | string | Short stable tag used as the row anchor, e.g. `P2023`, `W2019`. Letters and digits only. |
| `first_author` | string | Surname and initials of the first author as PubMed lists them, e.g. `Paszynska E`. For a guideline, the issuing body. |
| `title` | string | The paper's title. |
| `journal` | string | Journal abbreviation as PubMed lists it, e.g. `Cochrane Database Syst Rev`; for a guideline, the publisher or site. |
| `year` | integer | Year of publication. |
| `doi` | string | The DOI without a URL prefix, or empty if the paper has none. |
| `pmid` | string | The PubMed ID, or empty. |
| `design` | string | One of: `RCT`, `non-inferiority RCT`, `in situ`, `laboratory`, `systematic review`, `meta-analysis`, `narrative review`, `commentary`, `letter`, `guideline`, `cross-sectional`, `case-control`, `cohort`. |
| `topic` | string | One of the site's topics: `hydroxyapatite`, `flossing`, `water flosser`, `electric toothbrush`, `xylitol`, `oil pulling`, `tongue scraping`, `probiotics`, `recall interval`, `erosion`, `sugar`, `sensitivity`, `bad breath`, `tonsil stones`, `recession`, `gingivitis`, `calculus`, `mouthwash`, `microbiome`, `fluoride`, `health claims`. |
| `n` | string | Size as the paper states it, e.g. `189 adults` or `35 trials, 3,929 adults`; `—` when not applicable. |
| `duration` | string | Follow-up or intervention length as the paper states it; `—` when not applicable. |
| `funding_statement` | string | A verbatim quotation in double quotation marks. A section label ending in a colon may precede the quotation (`Acknowledgements: "…"`) when the statement lives in that section. Otherwise one of the literal phrases below. |
| `competing_interests` | string | Same rule: a verbatim quotation, or a literal phrase. |
| `funder_type` | string | One of: `manufacturer`, `manufacturer-employed authors`, `public/charity`, `none declared`, `not stated`, `mixed`. |
| `funder_name` | string | The funder as named in the statement; `none declared`; `not stated`; or `Named as a project title only — funder not stated` when the funding section gives only a grant title. |
| `funder_type_basis` | string | Which evidence set `funder_type`. One of: `funding statement`, `competing-interests statement`, `affiliation (PubMed)`, `none available`. |
| `affiliations_readable` | string or null | The author-affiliation line(s) exactly as PubMed shows them, joined with ` \| ` when there are several; `null` when not recorded. Recorded whenever the statement itself could not be read. |
| `affiliations_source_url` | string or null | The PubMed (or PMC) record the affiliation line was read on; `null` when `affiliations_readable` is `null`. |
| `used_on` | array of strings | Site paths of the pages that cite the paper, e.g. `["/hydroxyapatite-toothpaste.html"]`. |
| `statement_read_on` | string | The date the statements were read, `YYYY-MM-DD`. |
| `source_url_for_statement` | string | The page or PDF where the statements were read: a PMC article page, a publisher page, an NCBI Bookshelf page, or, when nothing could be read, the DOI or PubMed record that was tried. |

Guideline rows may also carry `url`, the official page of the document.

## Literal phrases

Use these exactly, with no quotation marks around them.

| Phrase | When |
|---|---|
| `No funding statement in the paper` | The full text was read and has no funding statement. |
| `No statement in the paper` | The full text was read and has no competing-interest statement. |
| `Statement not readable (paywalled)` | The full text is behind a paywall or a site that refuses automated reading, so the statement could not be checked. `funder_type` is then `not stated` unless a PubMed affiliation names a manufacturer as an author's employer. |
| `None declared` | The paper says explicitly that it had no funding, or no competing interests. (In practice the paper's own sentence is quoted instead, and `funder_type` is `none declared`.) |
| `Public body — not applicable` | Guidelines and regulator documents (SCCS, NICE, the FTC, the UK toolkit), used in both statement fields. |

## Funder types

| Value | Meaning |
|---|---|
| `manufacturer` | The funding statement names a company that sells the product studied. |
| `manufacturer-employed authors` | A funding line, an interests line or the PubMed affiliation names such a company as an author's employer. |
| `public/charity` | A public body, university, research council or charity is named as the funder. |
| `mixed` | A public funder plus a company contribution, such as donated product. |
| `none declared` | The paper says it received no funding. |
| `not stated` | Nothing readable says who paid. |

## Adding a row

Append an object with every field above, in that order, and rebuild the page. Check that the DOI resolves and that PubMed returns the paper's title for the PMID. The site's build gate refuses a row whose statement fields contain text outside quotation marks that is not one of the literal phrases.