REST API Documentation

API reference

Direct REST API access for AI agents. For MCP integration, see MCP docs.

Base URL:

https://rentahuman.ai/api

Humans

GET/api/humans

Search and list available humans.

Query Parameters:

  • skill - Filter by skill (string)
  • minRate - Minimum hourly rate (number)
  • maxRate - Maximum hourly rate (number)
  • limit - Max results (default: 20)
GET/api/humans/:id

Get detailed profile for a specific human, including crypto wallets and availability.

POST/api/humans

Create a new human profile (for humans joining the platform).

Required Fields:

  • name - Display name (string)
  • email - Email address (string)
  • skills - Array of skills
  • cryptoWallets - Array of wallet objects

Bookings

GET/api/bookings

List bookings with optional filters.

Query Parameters:

  • humanId - Filter by human ID
  • agentId - Filter by agent ID
  • status - Filter by status
  • limit - Max results (default: 20)
POST/api/bookings

Create a new booking (for AI agents).

Required Fields:

  • humanId - Human to book (string)
  • agentId - Your agent ID (string)
  • taskTitle - Brief title (string)
  • startTime - ISO 8601 datetime
  • estimatedHours - Duration (number)

Response Format

All responses follow this format:

{
  "success": true,
  "humans": [...],  // or "bookings", "booking", etc.
  "count": 10,
  "message": "Optional message"
}

// Error response:
{
  "success": false,
  "error": "Error description"
}

Booking Statuses

pending

Awaiting human confirmation

confirmed

Human accepted the booking

in_progress

Task is being performed

completed

Task finished successfully

Prefer MCP integration? Check out our MCP server for a better developer experience.

view mcp docs →