Medsafe Recalls NZ

Use the read-only Python CLI to retrieve and filter records exposed by the official first-party source. Every command supports --json, bounded requests, stable exit codes, source URLs and retrieval timestamps.

Commands

# list latest recall and safety resources
python3 scripts/cli.py latest --json
# search official notices
python3 scripts/cli.py search QUERY --json
# search medicine recalls
python3 scripts/cli.py medicine NAME --json
# search medical-device recalls
python3 scripts/cli.py device NAME --json
# find a recall identifier
python3 scripts/cli.py recall ID --json

Add --limit N (1–100) to bound any command. Human output is the default.

Coverage and interpretation

• Recall retrieval is not medical advice.
• Do not stop a medicine without professional guidance unless the official notice explicitly directs it.
• Preserve exact batch or lot scope and distinguish recalls from safety communications.

The CLI submits Medsafe's public read-only search form and parses its server-rendered recall table. Exact lookup parses the labelled official detail table, including product type, reference, brand, model, affected batch/model/software scope, recalling organisation, manufacturer, issue, action, level and commencement date when published.

Resources

• scripts/cli.py — canonical command entrypoint
• scripts/test_contract.py — deterministic repository contract audit
• scripts/smoke_test.py — parser fixture and bounded live probe
• tests/fixtures/recalls.html and recall-detail.html — list/detail and no-result parser fixtures
• references/source-notes.md — feasibility, provenance and source limits