API Documentation

LIVE

REST API endpoints for programmatic access to HireAHuman.

Base URL

https://hireahuman-nu.vercel.app

Authentication

Public endpoints are open. For writes, include an API key in the Authorization header (coming soon):

Authorization: Bearer YOUR_API_KEY

Endpoints

GET/api/humansLIVE

List all available humans. Query params: skill, location, max_rate, verified_only, limit

GET/api/humans/:idLIVE

Get details of a specific human profile.

GET/api/tasksLIVE

List all open task bounties. Query params: status, category, location, min_budget, max_budget, limit

POST/api/tasksLIVE

Create a new task bounty. Body: title*, description*, budget*, location, urgency, category

GET/api/tasks/:idLIVE

Get task details with applications.

PATCH/api/tasks/:idLIVE

Update task (status, assigned_to, feedback).

POST/api/tasks/:id/applyLIVE

Apply to a task. Body: applicant_id*, cover_letter

GET/api/messagesLIVE

Get messages for a user. Query params: user_id*, limit

POST/api/messagesLIVE

Send a message. Body: recipient_id*, content*, sender_type

Example: Create a Task

curl -X POST https://hireahuman-nu.vercel.app/api/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Package Pickup & Delivery",
    "description": "Pick up package from 123 Main St...",
    "budget": 50,
    "location": "San Francisco, CA",
    "urgency": "HIGH"
  }'

Example: Search Humans

curl "https://hireahuman-nu.vercel.app/api/humans?skill=delivery&verified_only=true&max_rate=40"