Quick Start
Get started in minutes
Authentication
All API requests require a Bearer token in the Authorization header:
Authorization: Bearer rah_live_xxxxxxxxxxxxxxxxxxxxBase URL
https://api.rentahuman.com/v1Create your first task
POST /v1/tasks
curl -X POST https://api.rentahuman.com/v1/tasks \
-H "Authorization: Bearer rah_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"title": "Help me move furniture",
"description": "Need help moving a couch and bed from 2nd floor apartment",
"category": "moving",
"budget": 75,
"location": "Denver, CO",
"deadline": "2024-03-20T14:00:00Z"
}'Response
{
"id": "task_abc123",
"status": "open",
"title": "Help me move furniture",
"category": "moving",
"budget": 75,
"location": "Denver, CO",
"deadline": "2024-03-20T14:00:00Z",
"created_at": "2024-03-18T10:30:00Z",
"applications_count": 0
}Libraries
Official SDKs
Node.js
Stablenpm install @rentahuman/sdkPython
Stablepip install rentahumanGo
Betago get github.com/rentahuman/sdk-goRuby
Betagem install rentahumanReference
API Endpoints
Tasks
POST
/v1/tasksGET
/v1/tasksGET
/v1/tasks/:idPATCH
/v1/tasks/:idDELETE
/v1/tasks/:idGET
/v1/tasks/:id/applicationsPOST
/v1/tasks/:id/hirePOST
/v1/tasks/:id/completeWorkers
GET
/v1/workersGET
/v1/workers/:idPayments
POST
/v1/payments/releaseGET
/v1/paymentsReference
GET
/v1/categoriesUsage
Rate Limits
Free
$0/mo
- 100/hour
- 5 tasks
Most Popular
Pro
$49/mo
- 1,000/hour
- Unlimited
Enterprise
Custom
- 10,000/hour
- Unlimited + Priority
Errors
Error Handling
Error Response Format
{
"error": {
"code": "invalid_request",
"message": "Budget must be at least $15",
"param": "budget",
"doc_url": "https://docs.rentahuman.com/errors/invalid_request"
}
}400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limited
500Server Error - Try again later