Esta página se muestra en inglés. La versión en español está en camino.
Request a quote for a homeowner
POST Preview Needs human consent
Submit a quote request on a consenting homeowner's behalf.
POST https://api.quotrr.com/v1/quote-requests
Creates a quote request from a homeowner to a contractor. Because this acts for a person, it requires a delegated, scoped, expiring consent token signed by that homeowner through OAuth 2.0 with PKCE. The action is logged in the homeowner's audit trail and is reversible for 24 hours.
Authentication
Bearer consent token in the Authorization header. The token must carry the quote:write scope and name the acting homeowner.
Scope: quote:write
Request
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| Authorization | header | Required | string | Bearer |
| contractor_handle | body | Required | string | The contractor to request a quote from. |
| trade | body | Required | string | Trade slug for the job. |
| zip | body | Required | string | Where the work is. |
| details | body | Optional | string | Free-text scope from the homeowner. |
Example request
curl -s -X POST https://api.quotrr.com/v1/quote-requests \
-H "Authorization: Bearer <consent-token>" \
-H "Content-Type: application/json" \
-d '{"contractor_handle":"phenomenal-pools","trade":"pools","zip":"95814","details":"Replaster, 18k gallon pool"}'Response
| Field | Type | Description |
|---|---|---|
| request_id | string | Identifier for the created quote request. |
| status | string | Always pending on creation. |
| reversible_until | ISO date-time | The action can be undone before this time. |
Example response
{
"request_id": "qr_8c1f...",
"status": "pending",
"reversible_until": "2026-06-02T09:00:00Z"
}