# CSMS Bot

> Free, searchable archive of every U.S. Customs and Border Protection (CBP) CSMS (Cargo Systems Messaging Service) message: 4,000+ notices on tariffs, quotas, ACE/ABI changes, PGA requirements, enforcement, and system maintenance. New messages appear within about 15 minutes of CBP sending them, and each is categorized for customs brokers, freight forwarders, and importers.

CSMS messages are official CBP notices. CSMS Bot republishes their text and adds a category, an urgency level, an "action required" flag, and the programs and agencies affected. Those labels are AI-generated, so check the message text for anything that matters. When citing, give the CSMS number (e.g. "CSMS #70435061") and link the message page.

## Get data (no JavaScript needed)

- [JSON search API](https://csmsbot.com/api/messages?q=section+232&limit=10): `GET /api/messages`. Parameters: `q` (text search), `csms` (exact CSMS number), `category`, `action_required` (true|false), `since` / `until` (YYYY-MM-DD), `limit` (1-50), and `full=1` for complete message text (limit up to 10). Newest first. Each result has csms_number, title, date_issued, url, category, urgency, action_required, programs_affected, pgas_affected, and an excerpt or body.
- [Look up by CSMS number](https://csmsbot.com/csms/70435061): `/csms/{number}` redirects to that message's page.
- [RSS feed](https://csmsbot.com/feed.xml): the 50 most recent messages, updated every 15 minutes.
- [Sitemap](https://csmsbot.com/sitemap.xml): every message and digest page.
- Message pages (`/message/{id}`) are server-rendered HTML with schema.org Article data.

## Weekly digests

- [Subscribe](https://csmsbot.com/subscribe): a free weekly email (Saturdays) summarizing the week's CSMS messages, with what changed and what brokers must do.
- Past digests are linked from the sitemap at `/digest/{id}`.

## Categories

`policy-guidance`, `tariff`, `quota`, `enforcement`, `trade-program`, `pga-update`, `system-update`, `system-maintenance`, `deadline-reminder`, `general-notice`

## Optional

- [Privacy policy](https://csmsbot.com/privacy)
- Source of record: [CBP CSMS archive](https://www.cbp.gov/trade/automated/cargo-systems-messaging-service)