# Saving and sharing (Texas Bill Atlas)

There are no accounts. A person's watchlist and filters live in their browser; they can carry them in a link or file, or sync them with a private link.

- **Links to a view**: the tracker's address describes the view, e.g. `https://billatlas.org/explorer?topic=Water`; a bill's page is `https://billatlas.org/bill/HB1`. Older `#all?topic=Water` links still open.
- **Share links**: `https://billatlas.org/explorer#list=HB1,SB2` opens a read-only list (the older `#all?list=HB1,SB2` still works). For agents: fetch `https://agent.billatlas.org/bills/<ID>.md` for each id.
- **Export/import**: the watchlist file is JSON: `{"format": "texas-bill-atlas-watchlist-v1", "session": "90R", "bills": ["HB1", "SB2"]}`. Import also accepts any text listing bill numbers.
- **RSS**: `https://billatlas.org/live/feeds/<ID>.xml` per bill.

## Private sync links (read-only access for agents)

A sync list has an edit key and a view key (22 characters each). Never ask a person for their edit key; it lets anyone change the list. A view-only link looks like `https://billatlas.org/watchlist#sync=<view key>` (older links use `#watchlist?sync=<view key>`). With a view key:

- `GET https://billatlas.org/api/sync` with header `X-Sync-Key: <view key>` returns `{"mode": "view", "version": n, "data": {"watch": ["HB1", ...], "filters": {}}}`
- `GET https://billatlas.org/api/sync/feed/<view key>.xml` is an RSS feed of the latest actions on every bill in the list

Requests are rate limited per client address, per rolling hour: 1200 reads (including feeds), 300 writes and 10 new lists; agent search allows 1200 searches. Over the limit the service returns 429 with a `Retry-After` header in seconds. The service stores only the bill numbers, followed legislators' member codes, saved searches (names, search words and filters), a version and dates; keys are stored as one-way hashes. No names, emails or accounts.

---
Unofficial, independent open-source project; not a state website. Bill data comes from the Texas Legislative Council bulk files and can lag or contain errors. Topic, agency and impact tags are automated (caption rules or the Luna model reading the full text) and can be wrong. Not legal advice. Confirm on Texas Legislature Online before relying on anything here.
