For programs
Developers
Every address Dorworth News serves to programs, with a real sample of each, what it returns, how often it changes and its schema. Every address answers without a key but the API’s, whose key comes by email.
Addresses
Records
Each record in the export contract, at its own page’s address with /v1.json after it (and /v1.csv where the record is rows), in one envelope every kind shares.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/numbers/{figure}/v1.json | What it returnsA figure: every value with its unit, period, release date and first-published value, and every revision with its date. The Business desk’s four figures are at /business/data/{figure}/v1.json. | How often it changesAt each release of the figure | A sample/business/data/inflation/v1.json | Its schemafigure |
Address/numbers/{figure}/v1.csv | What it returnsThe same figure as rows: one for each value a period has had. | How often it changesAt each release of the figure | A sample/business/data/inflation/v1.csv | Its schemafigure-readings, one row each |
Address/dates/event/{key}/v1.json | What it returnsA calendar entry: its time as its source gives it, every calendar that lists it, and every change, oldest first. | How often it changesWhen a calendar moves, postpones, cancels or stops listing it | A sample/dates/event/house-floor-2026-11-09/v1.json | Its schemaevent |
Address/dates/v1.csv | What it returnsEvery entry still to come, one row each. | How often it changesWhen a calendar is read, every 15 minutes | A sample/dates/v1.csv | Its schemaevent-list, one row each |
Address/documents/{id}/v1.json | What it returnsA document in the source library: its issuer, its date, the original’s address and the kept copy’s, with the copy’s SHA-256 fingerprint. | How often it changesNever, once its copy is kept | A sample/documents/713/v1.json | Its schemadocument |
Address/documents/v1.csv | What it returnsEvery document in the library, one row each. | How often it changesWhen a document joins the library | A sample/documents/v1.csv | Its schemadocument-list, one row each |
Address/poll/{slug}/v1.json | What it returnsA Dorworth Poll: its method, its questions in order and its results. | How often it changesWith each version of the poll | A sampleNo Dorworth Poll has been published. A poll’s record answers here from the first one. | Its schemapoll |
Address/poll/{slug}/v1.csv | What it returnsThe poll’s results as rows. | How often it changesWith each version of the poll | A sampleNo Dorworth Poll has been published. A poll’s record answers here from the first one. | Its schemapoll-results, one row each |
Address{a story’s address}/v1.json | What it returnsA story: its headline, In brief, type label, desk, byline, sources and source note, and every correction, clarification, revision by the source or withdrawal. | How often it changesWith each dated note, or its withdrawal | A sample/2026/11/06/culture/the-decline-of-christianity-in-america-has-stopped-for-now/v1.json | Its schemastory |
Address/wire/{yyyy}/{mm}/{dd}/{DNS ID}/v1.json | What it returnsA Dorworth News Service (DNS) wire story, with the same fields as a story. | How often it changesWith each dated note, or its withdrawal | A sampleNo Dorworth News Service (DNS) wire story has been published: every kind of story the engine writes is proved first. A wire story’s record answers here from the first one. | Its schemawire-item |
Address/business/record/v2.json | What it returnsThe Business desk’s record: its four figures with their states, the next release and the Fed’s range, every value a number. | How often it changesEvery five minutes, and at each release | A sample/business/record/v2.json | Its schemabusiness-record |
Address/us-politics/bills/{congress}/{bill}/v1.json | What it returnsA bill of Congress: its sponsors, every action, every version of its text and the votes on it. | How often it changesWith each action, version or vote | A sample/us-politics/bills/119/hr2347/v1.json | Its schemabill |
Address/us-politics/votes/{chamber}/{congress}-{session}-{number}/v1.json | What it returnsA roll call: the question, the result, the totals and every member’s vote. | How often it changesOnly when the chamber corrects it | A sample/us-politics/votes/senate/119-2-279/v1.json | Its schemavote |
Address/us-politics/members/{slug}/v1.json | What it returnsA member of Congress: the seat, the party and the latest votes. | How often it changesWhen the chamber’s list changes, and with each vote | A sample/us-politics/members/lisa-murkowski/v1.json | Its schemamember |
Address/states/{state}/declarations/{id}/v1.json | What it returnsA FEMA disaster declaration: its kind, its dates, the counties it names and the statement OpenFEMA asks for. | How often it changesWhen FEMA revises it | A sample/states/florida/declarations/dr-4955-fl/v1.json | Its schemadeclaration |
Address/states/{state}/bills/{session}/{bill}/v1.json | What it returnsA state legislature’s bill: its sponsors, every action, every version of its text and the roll calls on it, from LegiScan’s record, with LegiScan’s credit. | How often it changesWith each action, version or roll call the legislature records | A sample/states/arizona/bills/2235/scr1037/v1.json | Its schemastate-bill |
Address/states/{state}/votes/{roll call}/v1.json | What it returnsA state legislature’s roll call: the bill, the question, the result, the totals and every member’s vote, from LegiScan’s record, with LegiScan’s credit. | How often it changesWhen the legislature’s journal of it changes | A sample/states/alaska/votes/1715874/v1.json | Its schemastate-vote |
Address/states/{state}/legislators/{person}/v1.json | What it returnsA state legislator: the chamber, the district and the party, from LegiScan’s record, with LegiScan’s credit. | How often it changesWith each session that lists them | A sample/states/alaska/legislators/11277/v1.json | Its schemastate-legislator |
Address/storms/alerts/{alert}/v1.json | What it returnsA National Weather Service alert: every message the Service sent of it, in its own words, with the messages each replaced, its counties and states, its end, and how it ended. | How often it changesWith each message the Service sends of it, read every minute | A sample/storms/alerts/pafg-hw-w-0023-2026/v1.json | Its schemaweather-alert |
Address/storms/{storm}/v1.json | What it returnsA tropical storm: each public advisory the National Hurricane Center issued, as issued, with its figures, and whether the Center still lists it. | How often it changesWith each advisory, read every five minutes while the Center lists it | A sampleThe National Hurricane Center has listed no storm since the desk began reading it. A storm’s record answers here from the first one it lists. | Its schematropical-storm |
Address/us-politics/money/committees/{FEC id}/v1.json | What it returnsA campaign committee: what it raised and spent in each period, from each report’s summary, with every amendment. Never a contributor. | How often it changesWith each report or amendment it files | A sample/us-politics/money/committees/C00800024/v1.json | Its schemacommittee |
Address/us-politics/lobbying/reports/{registrant}-{client}-{year}-{quarter}/v1.json | What it returnsA lobbying report: the registrant, the client, the amount, the issues and the period, with every amendment. | How often it changesWith each amendment | A sample/us-politics/lobbying/reports/401109039-70273-2026-q3/v1.json | Its schemalobbying-report |
Address/business/insiders/{accession}/v1.json | What it returnsAn insider’s report of a trade, as the filing states it, with every amendment. | How often it changesWith each amendment | A sample/business/insiders/0000950103-26-015176/v1.json | Its schemainsider-filing |
Address/us-politics/trades/{report}/v1.json | What it returnsA member of Congress’s report of trades, as the report states it, with its kept copy. Published as news and kept out of every file for sale. | How often it changesWith each amendment | A sample/us-politics/trades/senate-8f97b859-75e2-4739-8392-d375744aea97/v1.json | Its schemadisclosure-report |
The fields every record shares
The list of changes
Every dated change to every record, in one list.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/changes/v1.json | What it returnsEvery dated change to every record, newest first; ?since= with a time gives every change recorded after it, oldest first, and ?kind= or ?record= narrows it. | How often it changesWith every change, as it is recorded | A sample/changes/v1.json | Its schemachange-list |
Feeds
The newest stories and wire stories, each item carrying its part of the export contract.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/feed.xml | What it returnsThe site’s RSS 2.0 feed: the newest stories, each with its type label, record, status, sources and notes. | How often it changesWith each story published or changed | A sample/feed.xml | Its schemaRSS 2.0, with the record namespace below |
Address/feed.json | What it returnsThe same items as a JSON Feed 1.1, each with its part of the export contract in _dorworth. | How often it changesWith each story published or changed | A sample/feed.json | Its schemajson-feed |
Address/{desk}/feed.xml | What it returnsOne desk’s RSS feed. | How often it changesWith each story the desk publishes or changes | A sample/us-politics/feed.xml | Its schemaRSS 2.0, with the record namespace below |
Address/wire/feed.xml | What it returnsThe Dorworth News Service (DNS) wire’s RSS feed. | How often it changesWith each wire story published or changed | A sample/wire/feed.xml | Its schemaRSS 2.0, with the record namespace below |
Address/wire/feed.json | What it returnsThe wire’s JSON Feed 1.1. | How often it changesWith each wire story published or changed | A sample/wire/feed.json | Its schemajson-feed |
Address/wire/{state}/feed.xml | What it returnsOne state’s wire stories as RSS. | How often it changesWith each wire story placed in the state | A sample/wire/florida/feed.xml | Its schemaRSS 2.0, with the record namespace below |
The record namespace of the RSS feeds
Each RSS item carries its part of the export contract in the namespace https://dorworth.com/ns/record/v1, the JSON Feed the same in _dorworth.
Calendar files
The calendar as files a calendar program subscribes to (RFC 5545).
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/dates.ics | What it returnsThe whole calendar. | How often it changesWhen a calendar is read, every 15 minutes; each entry’s SEQUENCE rises with each change | A sample/dates.ics | Its schemaRFC 5545 (iCalendar) |
Address/dates/{desk}.ics | What it returnsOne desk’s calendar. | How often it changesAs the whole calendar | A sample/dates/business.ics | Its schemaRFC 5545 (iCalendar) |
Address/dates/event/{key}/calendar.ics | What it returnsOne entry, for a calendar program to add. | How often it changesWith each change to the entry | A sample/dates/event/house-floor-2026-11-09/calendar.ics | Its schemaRFC 5545 (iCalendar) |
Address/states/{state}/calendar.ics | What it returnsEvery entry placed in a state. | How often it changesAs the whole calendar | A sample/states/florida/calendar.ics | Its schemaRFC 5545 (iCalendar) |
Address/business/calendar/{release}.ics | What it returnsOne release on the Business desk’s calendar, with its period and the reading before it. | How often it changesWhen the agency moves the release | A sample/business/calendar/fed-fomc-2027-11-17.ics | Its schemaRFC 5545 (iCalendar) |
Schemas
The written schema of every record and delivery here (JSON Schema, draft 2020-12).
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/schemas/v1/{name}.json | What it returnsThe written schema of a record or a delivery: figure, event, document, poll, story, wire-item, business-record, change-list, bill, vote, member, declaration, committee, lobbying-report, insider-filing, disclosure-report, json-feed and the API’s four answers, with each file of rows. | How often it changesOnly with the code; within v1 fields are only added | A sample/schemas/v1/figure.json | Its schemaJSON Schema, draft 2020-12 |
The API, with a key
The read-only API, answered only with a key; each sample here is the first item of its real answer.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/api/v1/storiesWith a key | What it returnsPublished stories, newest first, with full text; ?section=, ?since=, ?place=, ?page= and ?limit= (up to 100). | How often it changesWith each story published or changed | A sample
| Its schemaapi-stories |
Address/api/v1/wireWith a key | What it returnsPublished wire stories, newest first, with full text, sources and review record; ?state=, ?source=, ?since=. | How often it changesWith each wire story published or changed | A sample
| Its schemaapi-wire |
Address/api/v1/documentsWith a key | What it returnsThe source library, newest document first; ?type= and ?issuer=. | How often it changesWhen a document joins the library | A sample
| Its schemaapi-documents |
Address/api/v1/pollsWith a key | What it returnsPublished Dorworth Polls, newest first. | How often it changesWith each poll published | A sample
| Its schemaapi-polls |
Checking the record
The weekly check of the newsroom’s audit log, as a statement and its timestamp proof.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/corrections/audit/{week}.txt | What it returnsThe week’s statement of the audit log, in three lines: the week, the count of entries and the log’s SHA-256 fingerprint. | How often it changesOnce a week; a week’s statement never changes | A sample/corrections/audit/2026-11-16.txt | Its schemaThree lines of text, as Standards describes |
Address/corrections/audit/{week}.txt.ots | What it returnsThe statement’s OpenTimestamps proof. | How often it changesOnce a week, when the calendar’s proof is kept | A sample/corrections/audit/2026-11-16.txt.ots | Its schemaAn OpenTimestamps proof |
For crawlers
What a search engine or an AI system reads first.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/robots.txt | What it returnsThe robots rules: every crawler welcome on every address. | How often it changesOnly with the code | A sample/robots.txt | Its schemaRFC 9309 (robots rules) |
Address/sitemap.xml | What it returnsThe sitemap index and its parts, every page and record with its last change. | How often it changesWith each page published or changed | A sample/sitemap.xml | Its schemaThe sitemaps protocol |
Address/news-sitemap.xml | What it returnsThe news sitemap: the stories of the last two days. | How often it changesWith each story published | A sample/news-sitemap.xml | Its schemaThe sitemaps protocol, with Google’s news extension |
Address/llms.txt | What it returnsA plain guide to the site for AI systems, with its data copies and terms. | How often it changesWith the site’s sections and settings | A sample/llms.txt | Its schemaThe llms.txt format |
Addresses from before the export contract
They answer as they always have, for programs written against them; the contract’s address beside each carries the same record with a written schema.
| Address | What it returns | How often it changes | A sample | Its schema |
|---|---|---|---|---|
Address/numbers/{figure}/json | What it returnsA figure’s data copy, with its newest reading in words. | How often it changesAt each release of the figure | A sample/business/data/inflation/json | Its schemaNone written. Its record: /numbers/{figure}/v1.json |
Address/numbers/{figure}/data.csv | What it returnsA figure’s readings as rows. | How often it changesAt each release of the figure | A sample/business/data/inflation/data.csv | Its schemaNone written. Its record: /numbers/{figure}/v1.csv |
Address/documents/{id}/json | What it returnsA document’s data copy. | How often it changesNever, once its copy is kept | A sample/documents/713/json | Its schemaNone written. Its record: /documents/{id}/v1.json |
Address/poll/{slug}/json | What it returnsA poll’s data copy. | How often it changesWith each version of the poll | A sampleNo Dorworth Poll has been published. A poll’s record answers here from the first one. | Its schemaNone written. Its record: /poll/{slug}/v1.json |
Address/wire/{yyyy}/{mm}/{dd}/{DNS ID}/json | What it returnsA wire story’s data copy. | How often it changesWith each dated note, or its withdrawal | A sampleNo Dorworth News Service (DNS) wire story has been published: every kind of story the engine writes is proved first. A wire story’s record answers here from the first one. | Its schemaNone written. Its record: /wire/{yyyy}/{mm}/{dd}/{DNS ID}/v1.json |
Address/business/record.json | What it returnsThe Business desk’s record, version 1, its values in words (“4.1%”). | How often it changesEvery five minutes, and at each release | A sample/business/record.json | Its schemaNone written. Its record: /business/record/v2.json |
How changes reach you
Each record says how many times it has changed and links its rows in the list of changes, which is also served as data: /changes/v1.json?since= with a time gives every change recorded after it, oldest first, and kind= or record= narrows it to one kind of record or one record.
A correction, a clarification or a withdrawal of a story or a wire story is also a notice at the top of every feed that carries it, naming the original’s ID; the original keeps its address and says what changed. A figure keeps each value as first published beside every revision, each with its date. A calendar entry keeps its history, and its calendar file’s SEQUENCE rises with every change, so a subscribed calendar updates the entry it has.
A change the source makes to its own record is “Revised by the source”; an error of ours is “Corrected”. Both are rows in the list, with the value before and after.
Versions and notice
Every record’s address carries its version (v1), as do the list of changes, the API and the schemas, and every record carries its schemaVersion. Within a version fields are only added, never removed or given a new meaning, so a program should pass over a field or a kind of record it does not know.
A change that would remove a field or change what one means makes a new version, at a new address beside the old one, and the old version keeps answering. A new version is listed on this page on the day it is added, so no program has to change on any day but its own.
The addresses from before the export contract, listed above, answer as they always have; each has the contract’s address beside it, which carries the same record with a written schema.
Terms and credit line
Dorworth News’s own content may be read, quoted, summarized and used by programs, training a model included, on one condition: wherever it is quoted or shown, credit it as “Dorworth News”, or “Dorworth News Service (DNS)” for the wire, with a link to the page. Each record carries its credit and the page of its terms in its terms field. A wire story is republished under the license, with the line “Source: Dorworth News Service (DNS), dorworth.com”.
Data from other providers shown on our pages, such as betting lines, scores and charts, belongs to those providers and is not licensed here; members of Congress’s financial disclosure reports, which we publish as news, are public records whose commercial use federal law limits; the Federal Election Commission’s campaign-finance figures, which we report as news, may not be used commercially, including as training data, under the Commission’s own terms; and state legislatures’ bill records come from LegiScan, which licenses them under Creative Commons Attribution 4.0, so credit LegiScan when you reuse them. Where a source’s terms ask for a statement, its records carry it.
Using the site’s records in a product you sell, or receiving them as one of the three offers, is agreed in writing. Ask any address no more often than once a minute.
Ask for a key
The API’s key comes by email. Write to desk@dorworth.com with the name of your publication or organization, a contact person, what you intend to do with the API and which of the three offers, if any, you want to discuss. Each key is issued to one partner, is sent with every request in the Authorization header (Authorization: Bearer and the key), and can be revoked. Keys are free for publishers and researchers at launch.