Pearl River Design API Documentation
Public lead-intake endpoints for Pearl River Design. No authentication required.
These endpoints accept contact-form and onboarding submissions for Pearl River Design. They are public and do not require an API key. The full machine-readable specification is published at /openapi.json.
ERRORS
Every endpoint returns structured JSON on failure: { "error": { "code", "message", "hint" } }.
VERSIONING & DEPRECATION POLICY
Every response includes an API-Version header. The current version is 1. Requests may optionally send an API-Version request header to pin to a specific version; omitting it uses the latest. Breaking changes will ship as a new version. A deprecated version will be announced on this page with at least 90 days' notice and a Deprecation / Sunset response header during the transition window.
/api/submit returns RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers on every response, plus Retry-After when the 5-requests-per-10-minutes limit is exceeded (429).
POST/api/submit
Submit the homepage/niche-page contact form. Rate limited to 5 requests per 10 minutes per IP.
curl -X POST https://pearlriverdesign.dev/api/submit \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Smith",
"business_name": "Smith Plumbing",
"business_type": "Plumber",
"phone": "845-555-0100",
"email": "jane@smithplumbing.com"
}'POST/api/onboarding
Submit the full client onboarding intake form for a site that's already being built.
curl -X POST https://pearlriverdesign.dev/api/onboarding \
-H "Content-Type: application/json" \
-d '{
"businessName": "Smith Plumbing",
"ownerFirstName": "Jane",
"phone": "845-555-0100",
"email": "jane@smithplumbing.com"
}'POST/api/inquiry
Log a lead into the internal CRM. Accepts the same payload shape as /api/submit.
curl -X POST https://pearlriverdesign.dev/api/inquiry \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Smith",
"business_name": "Smith Plumbing",
"business_type": "Plumber",
"phone": "845-555-0100",
"email": "jane@smithplumbing.com"
}'