Docs
Developer docs
The Quotrr API in plain terms: anonymized reads that are open, and writes that need a person's consent. Every endpoint below has a curl example and its request and response shapes.
Status: the read endpoints are live, the consent-gated writes are in preview. The full machine-readable spec is the OpenAPI 3.1 document at https://api.quotrr.com/openapi.json. This reference mirrors it.
Endpoints
GET
/v1/health Live
Health check
Liveness probe for the API.
GET
/v1/price-range Live
Get a local price range
Anonymized price range for a trade in a ZIP code.
GET
/v1/contractors Live
Find contractors
Public contractor profiles matching a trade and ZIP.
GET
/v1/contractors/{handle} Live
Get contractor reputation
The Quotrr Score and verified Props for one public handle.
POST
/v1/quote-requests Preview
Request a quote for a homeowner
Submit a quote request on a consenting homeowner's behalf.
POST
/v1/reviews Preview
Submit a review
Submit a review against a verified completed job.
OAuth scopes
Reads are open. Writes act for a person and need a delegated, scoped token that person signed.
| Scope | Grants |
|---|---|
price:read | Read anonymized local price ranges by trade and ZIP. |
contractors:read | Read public contractor profiles, the Quotrr Score, and verified Props. |
quote:write | Submit a quote request on a consenting homeowner's behalf. |
review:write | Submit a review for a verified completed job. |
Building an agent?
The MCP server, the OAuth flow, and how to read llms.txt are documented for agents.