Data and API
Everything the site publishes is available as files: no keys, no sign-up, no rate limit beyond good manners.
The files
| File | What is in it |
|---|---|
/api/v1/entities.json | All 45 entities: slug, name, layer, category, jurisdictions, the grade and every modifier that produced it, the verdict it rests on — what refusing costs, who receives you, the scope of the refusal, the quoted clause or the silence finding, its source URL and date — and the company's reply where there is one. Versioned; fields are added, never removed. |
/api/v1/changes.json | Every grade that has moved since publication: the entity, the grade before and after, when, and the commit that moved it. Empty until the site is published, and the file says so. |
/feed.xml | RSS of every verdict, with the clause each grade rests on quoted in the item rather than summarised. |
/changes.xml | RSS of the change feed. The same rules as the JSON. |
/entity/<slug>/badge.svg | The verdict as a small image: grade, what refusing costs, and the date last checked. It exists for every entity and always shows the current grade, so a badge earned as a B that is regraded shows the new grade the day it happens, wherever it is embedded. The embed snippet is offered on A and B pages. |
/embed/<slug>/ | The verdict as a card that drops into an article the way a tweet does. Editors that support oEmbed can paste the entity page's address instead and get the same card. |
/llms.txt and /llms-full.txt | For assistants and crawlers that read those: what the site is, and every verdict on one line each. |
Freshness and access
The files are regenerated on every build — always when a verdict changes — and cached at the edge for five minutes. They are served with an open cross-origin header, so a page on another site can fetch them directly. The build refuses to publish a quoted clause that is not in its archived document, and the same build writes these files, so they hold to the same rule as the pages.
If you need the archived documents themselves rather than the derived data, ask. The corpus is fetched daily and the crawler page says how.
Terms
- The grades, findings and change records are free to reuse, including commercially, with a link to the entity page they came from.
- The quoted clauses are the companies' own words and stay theirs. Quote them as quotations, with the company named and the date beside them.
- A grade is a reading of a document on a date. If you republish one, republish the date: policies move, and so do grades.
- Do not present the data as your own measurement, and do not turn Unrated into a grade. It means the document does not say what refusing costs, and this site does not grade silence.