Developer API

Use ExpDater as a backend service: create users, upload documents, and read OCR’d expiration dates over HTTPS.

Your API keys

No user selected. Append ?user_id=<your_user_id> to this page, or use the “Developer API” link from the main app after creating a user.

Quick start

1. Create a user

Use POST /users/new with your API key:

curl -X POST https://exp.bryerstone.com/users/new \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <your-api-key>" \
  -d '{"email":"user@example.com","phone":"15551234567","carrier":""}'

2. Upload a document

Use POST /upload (multipart form):

curl -X POST https://exp.bryerstone.com/upload \
  -H "X-API-Key: <your-api-key>" \
  -F "user_id=123" \
  -F "should_email=1" \
  -F "should_sms=0" \
  -F "file=@/path/to/document.png"

Responses include document_id and the best expiration date in ISO form as best_date_iso.

Rate limiting & quotas

Each key enforces a per-minute rate limit (RPM) and, optionally, a monthly quota. Starter/Pro plans will automatically adjust rate_limit_per_min and monthly_quota via Stripe webhooks.