PostalForm Projects

export POSTALFORM_API_KEY="pf_test_..."
BASE="https://projects.postalform.com/api/v1"

curl -s "$BASE/letters/quotes" \
  -H "Authorization: Bearer $POSTALFORM_API_KEY" \
  -d '{"document_id":"doc_8f21c4","certified":true}'
# -> {"quote_id":"quote_a92d1b","price_cents":1020,...}

curl -s "$BASE/letters" \
  -H "Authorization: Bearer $POSTALFORM_API_KEY" \
  -H "Idempotency-Key: invoice-1042" \
  -d '{"quote_id":"quote_a92d1b","recipient":{"name":"Ada Lovelace","line1":"1 Analytical Way","city":"San Francisco","state":"CA","postal_code":"94105"}}'
# -> {"id":"ord_c99ef3","status":"queued","mode":"test"}

const base = 'https://projects.postalform.com/api/v1'
const headers = {
  'Authorization': 'Bearer ' + process.env.POSTALFORM_TEST_API_KEY,
  'Content-Type': 'application/json',
}

const quote = await fetch(base + '/letters/quotes', {
  method: 'POST', headers,
  body: JSON.stringify({ document_id: doc.id, certified: true }),
}).then((res) => res.json())

const letter = await fetch(base + '/letters', {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': 'invoice-1042' },
  body: JSON.stringify({ quote_id: quote.quote_id, recipient }),
}).then((res) => res.json())
// letter.status -> 'queued', then webhooks take over

import os, requests

base = "https://projects.postalform.com/api/v1"
auth = {"Authorization": "Bearer " + os.environ["POSTALFORM_TEST_API_KEY"]}

quote = requests.post(base + "/letters/quotes", headers=auth,
    json={"document_id": doc_id, "certified": True}).json()

letter = requests.post(base + "/letters",
    headers={**auth, "Idempotency-Key": "invoice-1042"},
    json={"quote_id": quote["quote_id"], "recipient": recipient}).json()
# letter["status"] -> "queued", then webhooks take over