Skip to content

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

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.

Records: each address, what it returns, how often it changes, a sample and its schema
Address/numbers/{figure}/v1.jsonWhat 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 figureA sample/business/data/inflation/v1.jsonIts schemafigure
Address/numbers/{figure}/v1.csvWhat it returnsThe same figure as rows: one for each value a period has had.How often it changesAt each release of the figureA sample/business/data/inflation/v1.csvIts schemafigure-readings, one row each
Address/dates/event/{key}/v1.jsonWhat 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 itA sample/dates/event/house-floor-2026-11-09/v1.jsonIts schemaevent
Address/dates/v1.csvWhat it returnsEvery entry still to come, one row each.How often it changesWhen a calendar is read, every 15 minutesA sample/dates/v1.csvIts schemaevent-list, one row each
Address/documents/{id}/v1.jsonWhat 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 keptA sample/documents/713/v1.jsonIts schemadocument
Address/documents/v1.csvWhat it returnsEvery document in the library, one row each.How often it changesWhen a document joins the libraryA sample/documents/v1.csvIts schemadocument-list, one row each
Address/poll/{slug}/v1.jsonWhat it returnsA Dorworth Poll: its method, its questions in order and its results.How often it changesWith each version of the pollA sampleNo Dorworth Poll has been published. A poll’s record answers here from the first one.Its schemapoll
Address/poll/{slug}/v1.csvWhat it returnsThe poll’s results as rows.How often it changesWith each version of the pollA 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.jsonWhat 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 withdrawalA sample/2026/11/06/culture/the-decline-of-christianity-in-america-has-stopped-for-now/v1.jsonIts schemastory
Address/wire/{yyyy}/{mm}/{dd}/{DNS ID}/v1.jsonWhat it returnsA Dorworth News Service (DNS) wire story, with the same fields as a story.How often it changesWith each dated note, or its withdrawalA 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.jsonWhat 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 releaseA sample/business/record/v2.jsonIts schemabusiness-record
Address/us-politics/bills/{congress}/{bill}/v1.jsonWhat 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 voteA sample/us-politics/bills/119/hr2347/v1.jsonIts schemabill
Address/us-politics/votes/{chamber}/{congress}-{session}-{number}/v1.jsonWhat it returnsA roll call: the question, the result, the totals and every member’s vote.How often it changesOnly when the chamber corrects itA sample/us-politics/votes/senate/119-2-279/v1.jsonIts schemavote
Address/us-politics/members/{slug}/v1.jsonWhat 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 voteA sample/us-politics/members/lisa-murkowski/v1.jsonIts schemamember
Address/states/{state}/declarations/{id}/v1.jsonWhat 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 itA sample/states/florida/declarations/dr-4955-fl/v1.jsonIts schemadeclaration
Address/states/{state}/bills/{session}/{bill}/v1.jsonWhat 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 recordsA sample/states/arizona/bills/2235/scr1037/v1.jsonIts schemastate-bill
Address/states/{state}/votes/{roll call}/v1.jsonWhat 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 changesA sample/states/alaska/votes/1715874/v1.jsonIts schemastate-vote
Address/states/{state}/legislators/{person}/v1.jsonWhat 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 themA sample/states/alaska/legislators/11277/v1.jsonIts schemastate-legislator
Address/storms/alerts/{alert}/v1.jsonWhat 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 minuteA sample/storms/alerts/pafg-hw-w-0023-2026/v1.jsonIts schemaweather-alert
Address/storms/{storm}/v1.jsonWhat 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 itA 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.jsonWhat 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 filesA sample/us-politics/money/committees/C00800024/v1.jsonIts schemacommittee
Address/us-politics/lobbying/reports/{registrant}-{client}-{year}-{quarter}/v1.jsonWhat it returnsA lobbying report: the registrant, the client, the amount, the issues and the period, with every amendment.How often it changesWith each amendmentA sample/us-politics/lobbying/reports/401109039-70273-2026-q3/v1.jsonIts schemalobbying-report
Address/business/insiders/{accession}/v1.jsonWhat it returnsAn insider’s report of a trade, as the filing states it, with every amendment.How often it changesWith each amendmentA sample/business/insiders/0000950103-26-015176/v1.jsonIts schemainsider-filing
Address/us-politics/trades/{report}/v1.jsonWhat 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 amendmentA sample/us-politics/trades/senate-8f97b859-75e2-4739-8392-d375744aea97/v1.jsonIts schemadisclosure-report

Every dated change to every record, in one list.

The list of changes: each address, what it returns, how often it changes, a sample and its schema
Address/changes/v1.jsonWhat 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 recordedA sample/changes/v1.jsonIts schemachange-list

The newest stories and wire stories, each item carrying its part of the export contract.

Feeds: each address, what it returns, how often it changes, a sample and its schema
Address/feed.xmlWhat 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 changedA sample/feed.xmlIts schemaRSS 2.0, with the record namespace below
Address/feed.jsonWhat 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 changedA sample/feed.jsonIts schemajson-feed
Address/{desk}/feed.xmlWhat it returnsOne desk’s RSS feed.How often it changesWith each story the desk publishes or changesA sample/us-politics/feed.xmlIts schemaRSS 2.0, with the record namespace below
Address/wire/feed.xmlWhat it returnsThe Dorworth News Service (DNS) wire’s RSS feed.How often it changesWith each wire story published or changedA sample/wire/feed.xmlIts schemaRSS 2.0, with the record namespace below
Address/wire/feed.jsonWhat it returnsThe wire’s JSON Feed 1.1.How often it changesWith each wire story published or changedA sample/wire/feed.jsonIts schemajson-feed
Address/wire/{state}/feed.xmlWhat it returnsOne state’s wire stories as RSS.How often it changesWith each wire story placed in the stateA sample/wire/florida/feed.xmlIts schemaRSS 2.0, with the record namespace below

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.

The calendar as files a calendar program subscribes to (RFC 5545).

Calendar files: each address, what it returns, how often it changes, a sample and its schema
Address/dates.icsWhat it returnsThe whole calendar.How often it changesWhen a calendar is read, every 15 minutes; each entry’s SEQUENCE rises with each changeA sample/dates.icsIts schemaRFC 5545 (iCalendar)
Address/dates/{desk}.icsWhat it returnsOne desk’s calendar.How often it changesAs the whole calendarA sample/dates/business.icsIts schemaRFC 5545 (iCalendar)
Address/dates/event/{key}/calendar.icsWhat it returnsOne entry, for a calendar program to add.How often it changesWith each change to the entryA sample/dates/event/house-floor-2026-11-09/calendar.icsIts schemaRFC 5545 (iCalendar)
Address/states/{state}/calendar.icsWhat it returnsEvery entry placed in a state.How often it changesAs the whole calendarA sample/states/florida/calendar.icsIts schemaRFC 5545 (iCalendar)
Address/business/calendar/{release}.icsWhat 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 releaseA sample/business/calendar/fed-fomc-2027-11-17.icsIts schemaRFC 5545 (iCalendar)

The written schema of every record and delivery here (JSON Schema, draft 2020-12).

Schemas: each address, what it returns, how often it changes, a sample and its schema
Address/schemas/v1/{name}.jsonWhat 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 addedA sample/schemas/v1/figure.jsonIts schemaJSON Schema, draft 2020-12

The read-only API, answered only with a key; each sample here is the first item of its real answer.

The API, with a key: each address, what it returns, how often it changes, a sample and its schema
Address/api/v1/storiesWith a keyWhat 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 changedA sample
/api/v1/stories?limit=1, as it answers
{
  "ok": true,
  "page": 1,
  "totalPages": 18,
  "totalDocs": 18,
  "docs": [
    {
      "id": 14,
      "headline": "The decline of Christianity in America has stopped, for now. Pew’s own count says so",
      "deck": "The largest survey of American religion found 62 percent of adults still call themselves Christian, a share that has held since 2019 after falling for most of t… [the answer carries all 210 characters]",
      "label": "analysis",
      "url": "https://dorworth.com/2026/11/06/culture/the-decline-of-christianity-in-america-has-stopped-for-now",
      "section": "culture",
      "beat": "faith",
      "series": null,
      "geography": "national",
      "state": null,
      "places": [
        "US"
      ],
      "status": {
        "kind": "none"
      },
      "corrections": [],
      "authors": [
        "Chris Dorworth"
      ],
      "publishedAt": "2026-11-07T03:48:39.322Z",
      "updatedAt": "2026-11-07T04:48:41.650Z",
      "summary": [
        {
          "id": "6aeeada91218f40062957ad7",
          "leadIn": "Why it matters",
          "customLeadIn": null,
          "text": "For twenty years the story of American religion was a straight line down. The newest Religious Landscape Study says the line went flat."
        },
        {
          "id": "6aeeada91218f40062957ad8",
          "leadIn": "By the numbers",
          "customLeadIn": null,
          "text": "62 percent of U.S. adults are Christian, 29 percent are religiously unaffiliated and 7 percent belong to other religions; 44 percent pray daily and 33 percent a… [the answer carries all 192 characters]"
        },
        {
          "id": "6aeeada91218f40062957ad9",
          "leadIn": "The big picture",
          "customLeadIn": null,
          "text": "The losses were concentrated: mainline Protestants fell from 18 percent of adults in 2007 to 11 percent, and among self-described liberals the Christian share f… [the answer carries all 243 characters]"
        },
        {
          "id": "6aeeada91218f40062957ada",
          "leadIn": "What's next",
          "customLeadIn": null,
          "text": "Pew expects religiousness to decline again, because young adults are less religious than their elders and a religious upbringing holds less than it did."
        }
      ],
      "text": "The Religious Landscape Study is the largest regular measurement of what Americans believe, and its third edition, released on February 26, 2025, reported somet… [the answer carries all 2,258 characters]",
      "topics": [
        "Religion in America",
        "Primary sources"
      ],
      "image": null
    }
  ]
}
Its schemaapi-stories
Address/api/v1/wireWith a keyWhat 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 changedA sample
/api/v1/wire?limit=1, as it answers
{
  "ok": true,
  "page": 1,
  "totalPages": 1,
  "totalDocs": 0,
  "docs": []
}
Its schemaapi-wire
Address/api/v1/documentsWith a keyWhat it returnsThe source library, newest document first; ?type= and ?issuer=.How often it changesWhen a document joins the libraryA sample
/api/v1/documents?limit=1, as it answers
{
  "ok": true,
  "page": 1,
  "totalPages": 713,
  "totalDocs": 713,
  "docs": [
    {
      "id": 713,
      "title": "Alan Armstrong: periodic transaction report for Nov. 20, 2026",
      "issuingBody": "U.S. Senate, Office of Public Records",
      "documentType": "filing",
      "documentDate": "2026-11-20T00:00:00.000Z",
      "originalUrl": "https://efdsearch.senate.gov/search/view/ptr/8f97b859-75e2-4739-8392-d375744aea97/",
      "sha256": "5acf35853ab759bd6d13810106c0115fee09bfc36f0b6cbab315151f43f979fa",
      "retrievedAt": "2026-11-20T21:35:24.511Z",
      "summary": null,
      "excerpt": null,
      "excerptLocation": null,
      "url": "https://dorworth.com/documents/713",
      "file": "https://dorworth.comhttps://dorworth.com/api/documents/file/senate-ptr-8f97b859-75e2-4739-8392-d375744aea97.html?prefix=documents"
    }
  ]
}
Its schemaapi-documents
Address/api/v1/pollsWith a keyWhat it returnsPublished Dorworth Polls, newest first.How often it changesWith each poll publishedA sample
/api/v1/polls?limit=1, as it answers
{
  "ok": true,
  "page": 1,
  "totalPages": 1,
  "totalDocs": 0,
  "docs": []
}
Its schemaapi-polls

The weekly check of the newsroom’s audit log, as a statement and its timestamp proof.

Checking the record: each address, what it returns, how often it changes, a sample and its schema
Address/corrections/audit/{week}.txtWhat 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 changesA sample/corrections/audit/2026-11-16.txtIts schemaThree lines of text, as Standards describes
Address/corrections/audit/{week}.txt.otsWhat it returnsThe statement’s OpenTimestamps proof.How often it changesOnce a week, when the calendar’s proof is keptA sample/corrections/audit/2026-11-16.txt.otsIts schemaAn OpenTimestamps proof

What a search engine or an AI system reads first.

For crawlers: each address, what it returns, how often it changes, a sample and its schema
Address/robots.txtWhat it returnsThe robots rules: every crawler welcome on every address.How often it changesOnly with the codeA sample/robots.txtIts schemaRFC 9309 (robots rules)
Address/sitemap.xmlWhat it returnsThe sitemap index and its parts, every page and record with its last change.How often it changesWith each page published or changedA sample/sitemap.xmlIts schemaThe sitemaps protocol
Address/news-sitemap.xmlWhat it returnsThe news sitemap: the stories of the last two days.How often it changesWith each story publishedA sample/news-sitemap.xmlIts schemaThe sitemaps protocol, with Google’s news extension
Address/llms.txtWhat 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 settingsA sample/llms.txtIts schemaThe llms.txt format

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.

Addresses from before the export contract: each address, what it returns, how often it changes, a sample and its schema
Address/numbers/{figure}/jsonWhat it returnsA figure’s data copy, with its newest reading in words.How often it changesAt each release of the figureA sample/business/data/inflation/jsonIts schemaNone written. Its record: /numbers/{figure}/v1.json
Address/numbers/{figure}/data.csvWhat it returnsA figure’s readings as rows.How often it changesAt each release of the figureA sample/business/data/inflation/data.csvIts schemaNone written. Its record: /numbers/{figure}/v1.csv
Address/documents/{id}/jsonWhat it returnsA document’s data copy.How often it changesNever, once its copy is keptA sample/documents/713/jsonIts schemaNone written. Its record: /documents/{id}/v1.json
Address/poll/{slug}/jsonWhat it returnsA poll’s data copy.How often it changesWith each version of the pollA 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}/jsonWhat it returnsA wire story’s data copy.How often it changesWith each dated note, or its withdrawalA 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.jsonWhat it returnsThe Business desk’s record, version 1, its values in words (“4.1%”).How often it changesEvery five minutes, and at each releaseA sample/business/record.jsonIts 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.