BlastPermit

Permit management and regulatory compliance for commercial blasting operations. Handles multi-jurisdiction filing, threshold monitoring, and incident pre-notification across 52 U.S. jurisdictions (50 states + DC + federal BLM land overlay).

⚠️ Note: If you're still on v1.x, the --region flag has changed. See the migration guide. Yes, I know. Sorry.

---

Features

• Multi-jurisdiction filing — 52 jurisdictions supported (up from 47 as of this release; added MT-federal, WY-federal, NM-state-split, ID-border, AK-remote — gracias Renata por la lista final)
• Seismograph auto-reporting — automatic peak particle velocity (PPV) submissions to regulatory bodies via registered seismograph integrations; supports Instantel, Nomis, White Industries, and generic CSV webhook
• Bulk-permit batching — submit up to 500 permits in a single batch job; respects per-jurisdiction daily rate limits automatically; partial-failure handling with retry queue (this was BP-3709, finally done)
• Pre-blast notifications — automated neighbor/agency notifications per jurisdiction rules
• Threshold enforcement — PPV and airblast overpressure limits enforced before submission
• Audit trail — immutable log of all submissions, amendments, and withdrawals

---

Quickstart

Install:

pip install blastpermit

Configure credentials:

blastpermit configure --api-key YOUR_API_KEY --org-id YOUR_ORG_ID

Submit a single permit:

blastpermit submit \
  --jurisdiction MT-federal \
  --site-id "site-00492" \
  --blast-date 2026-07-10 \
  --charge-weight 4200 \
  --charge-unit lbs \
  --distance-to-structure 850 \
  --delay-pattern echelon \
  --notify-adjacent \
  --output json

Bulk batch submission:

blastpermit batch submit \
  --input permits.csv \
  --batch-size 100 \
  --on-failure continue \
  --report-path ./batch-report.json

Check seismograph auto-report status:

blastpermit seismo status --permit-id BP-2026-00441 --verbose

---

Supported Jurisdictions

As of v2.5.0: 52 jurisdictions.

Full list in docs/jurisdictions.md. Newly added:

Code	Description
MT-federal	Montana — BLM/federal overlay permits
WY-federal	Wyoming — BLM/federal overlay permits
NM-state-split	New Mexico — state + NMED dual filing
ID-border	Idaho — cross-border zone with OR compact
AK-remote	Alaska — remote-site single-filing exemption track

---

Seismograph Integration

BlastPermit can receive data directly from your seismograph hardware or monitoring service and auto-submit required PPV/airblast reports to the relevant authority.

# blastpermit.yml
seismograph:
  provider: instantel
  webhook_secret: "${SEISMO_WEBHOOK_SECRET}"
  auto_report: true
  report_delay_minutes: 15
  jurisdictions:
    - MT-federal
    - WY-federal

Supported providers: instantel, nomis, white_industries, csv_webhook

See docs/seismograph.md for full setup. The Nomis integration is still a little flaky on firmware < 4.2 — ha sido un dolor de cabeza, working on it (#BP-3912).

---

Configuration Reference

Full CLI flag reference: blastpermit --help or docs/cli.md.

Environment variables:

Variable	Description
BLASTPERMIT_API_KEY	API key (prefer keychain over env in prod)
BLASTPERMIT_ORG_ID	Organization ID
BLASTPERMIT_ENV	production or staging (default: production)
SEISMO_WEBHOOK_SECRET	Seismograph webhook HMAC secret

---

Changelog highlights — v2.5.0

• Jurisdiction count: 47 → 52 (see above)
• Seismograph auto-reporting GA (was beta since v2.3)
• Bulk-permit batching: new batch subcommand, --on-failure flag, partial retry queue
• Breaking: --region renamed to --jurisdiction, --structure-dist → --distance-to-structure, --pattern → --delay-pattern
• Fixed: MT state portal timeout regression introduced in v2.4.1 (sorry about that one)

Full changelog: CHANGELOG.md

---

License

Business Source License 1.1. See LICENSE. Converts to Apache 2.0 on 2029-01-01.