Developers
Build on the Sortedhey API
Send work to trusted trades from your own systems and get every quote, status change and invoice back automatically. We are delivering the API, API keys and webhooks now.
What you can do
Keep maintenance work inside the tools you already use
Create and track jobs
Raise a job from your helpdesk or property system and follow it from request to completion without logging in.
Read quotes and invoices
Pull quotes and invoices into your own approval flow and accounts, so nobody retypes a figure.
Report on spend by entity
Fetch spend reports for each entity (a property, a building or a department) and feed them straight into your dashboards.
Authentication
One API key, one header
Create an API key in your business account, keep it on your server and send it as a bearer token. This lists your latest jobs.
curl "https://92.4.157.56.sslip.io/api/v1/jobs?limit=10" \
-H "Authorization: Bearer $SORTEDHEY_API_KEY"Responses are JSON. The same pattern works for quotes, invoices and spend reports, and the API reference lists every endpoint.
Webhooks
Hear about changes the moment they happen
We sign every webhook with the open Standard Webhooks specification, so you can verify it with a maintained library instead of hand-rolled code. Each delivery carries webhook-id, webhook-timestamp and webhook-signature headers. Verify the raw request body before you trust it.
import { Webhook } from "standardwebhooks";
const wh = new Webhook(process.env.SORTEDHEY_WEBHOOK_SECRET);
// rawBody is the unparsed request body, headers are the request headers
const event = wh.verify(rawBody, headers); // throws if the signature is invalidAI assistants
Let your AI assistant work with Sortedhey
Connect Claude, Cursor or any assistant that supports the Model Context Protocol (MCP), the open standard for giving assistants access to tools. It signs in as you, or uses an API key you limit, and sees only what that account or key is allowed to do.
- Search tradespeople, request jobs and follow them from a chat.
- Accepting a quote or paying an invoice happens only after you confirm.
- Every change is recorded in the audit log as made through MCP.
Available on our demo data today, with a sandbox payment provider.
Ready to connect your systems?
Get an API key, try the calls above and tell us what you build. We read every message.