REST · v1

API documentation

Production-ready endpoints powering Findhelpy. Bearer token auth, JSON requests/responses.

Base URL

https://api.findhelpy.app

Auth

Authorization: Bearer <token>

Endpoints

POST/v1/auth/session

Create authenticated session

GET/v1/tasks

List tasks (filter by status, district)

POST/v1/tasks

Create a new task

GET/v1/tasks/:id

Get task details

PATCH/v1/tasks/:id

Update task fields

DELETE/v1/tasks/:id

Delete a task

POST/v1/tasks/:id/applications

Worker applies to task

POST/v1/tasks/:id/select-worker

Customer picks a worker

POST/v1/tasks/:id/share

Reveal phone or address

POST/v1/tasks/:id/review

Submit rating + review

GET/v1/workers

List workers, with filters

GET/v1/workers/:id

Get worker profile

POST/v1/reports

Submit a moderation report

POST/v1/admin/suspend

Suspend worker (admin only)

Example request

POST /v1/tasks
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "title": "Hang curtain rod",
  "district": "15 Bezirk",
  "when": "today",
  "budget": 70,
  "category": "Mounting"
}

Example response

{
  "id": "tsk_8h2k3",
  "status": "open",
  "createdAt": "2025-05-14T10:24:00Z",
  "shared": { "phone": false, "address": false }
}

Webhooks

• task.created
• application.received
• worker.selected
• task.completed
• report.opened

Rate limit: 600 req / min · SLA 99.95%