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.

Read the agent docs View the OpenAPI spec