REST API. Five-minute integration.

Upload a bill, get JSON

curl -X POST https://api.utilitybillparse.com/v1/bills \
  -H "Authorization: Bearer $UBP_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@con-edison-may.pdf" \
  -F "vendor_short_name=ConEdison" \
  -F "webhook_url=https://yourapp.com/hooks/ubp"

Sample response

// POST /v1/bills returns 202 immediately. Poll the document URL
// or wait for the batch.completed webhook delivery.
{
  "id": "doc_a40f8293-...",
  "object": "bill",
  "status": "queued",
  "batch_id": "bat_2de40829-...",
  "document_id": "doc_a40f8293-...",
  "total_credits": 1,
  "total_usd_cents": 39,
  "webhook_secret": "whsec_…",       // returned once; store securely
  "links": {
    "self":  "/v1/documents/doc_a40f8293-...",
    "batch": "/v1/batches/bat_2de40829-..."
  }
}