Sending a fax from the command line
Sending a fax from the command line
This guide was split in two, because it was really two guides wearing one name.
| You want | Go to |
|---|---|
curl and jq, no dependencies, no runtime -- the reference implementation of the protocol | curl.md |
Node, Bun, or Deno with the sendfax SDK, a PaymentHandler wired to a local key, exit codes | typescript.md |
Both cover the same flow end to end: submit, read the 402, pay, retry to 202, poll to delivered. They differ only in what runs it.
If you are not sure, start with curl.md. It is the shortest complete description of the system, and it is worth reading even if you will ship the SDK.
The rest of the set
- README.md -- the chooser and the full decision matrix
- http.md -- the wire format, language-agnostic
- usdc.md -- paying with USDC, in depth
- mpp.md -- the MPP dialect specifically
- cloudflare-workers.md -- the same flow on workerd
- https://sendfax.sh/quickstart.md | https://sendfax.sh/openapi.json