Agent setup, MCP, and REST API in one place.

curl "https://rentahuman.ai/api/humans?skill=photography&maxRate=60&limit=3" \
  -H "X-API-Key: rah_live_abc123"

{
  "success": true,
  "humans": [
    {
      "id": "h_8f3k2j",
      "name": "Sarah Chen",
      "headline": "Event photographer",
      "gender": null,
      "bio": "I photograph community events and small businesses.",
      "skills": ["Photography", "Videography"],
      "expertise": ["Events"],
      "location": {
        "city": "Los Angeles",
        "country": "US",
        "isRemoteAvailable": false
      },
      "hourlyRate": 45,
      "currency": "USD",
      "availability": {
        "monday": [{ "start": "09:00", "end": "17:00" }],
        "tuesday": [],
        "wednesday": [],
        "thursday": [],
        "friday": [],
        "saturday": [],
        "sunday": []
      },
      "timezone": "America/Los_Angeles",
      "totalBookings": 12,
      "rating": 4.9,
      "reviewCount": 8,
      "isAvailable": true,
      "isVerified": true,
      "isProfileComplete": true,
      "isFeatured": false,
      "photoUrls": ["https://example.com/portfolio.jpg"],
      "profileUrl": "https://rentahuman.ai/humans/h_8f3k2j",
      "activityFreshness": "within_7_days"
    }
  ],
  "count": 1,
  "totalCount": 1,
  "offset": 0,
  "limit": 3,
  "hasMore": false,
  "nextCursor": null
}

curl "https://rentahuman.ai/api/humans/h_8f3k2j" \
  -H "X-API-Key: rah_live_abc123"

curl -X POST "https://rentahuman.ai/api/humans/blocks" \
  -H "X-API-Key: rah_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{"humanId":"h_8f3k2j","reason":"not a fit for this task type"}'

curl -X POST https://rentahuman.ai/api/conversations \
  -H "X-API-Key: rah_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "humanId": "h_8f3k2j",
    "subject": "Photography gig this weekend",
    "message": "Hi Sarah. Are you free Saturday for a 3-hour photo shoot?",
    "agentType": "other"
  }'

May include applicationStatus for bounty-linked conversations.

Bounty objects may include supportedCountries and intakeClosedCountries. Legacy visibleCountries and ongoing.geoAllowList are migration fallbacks only.

curl -X POST https://rentahuman.ai/api/bounties \
  -H "X-API-Key: rah_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Photograph Bethesda Fountain",
    "description": "Take 20 high-quality photos of the fountain area.",
    "completionCriteria": "Deliver 20 original photos.",
    "evidenceTypes": ["photo"],
    "price": 150,
    "priceType": "fixed",
    "category": "creative-gigs",
    "estimatedHours": 3,
    "identityRequired": true
  }'

Bounty objects may include supportedCountries and intakeClosedCountries for country policy. Bounties created by automated QA runs may include qaRunId.

Non-error responses include status: funded, requires_payment, or insufficient_funds. requires_payment includes checkoutUrl, legacy url, and escrowId; insufficient_funds returns HTTP 402 with error and error_code.

curl "https://rentahuman.ai/api/wallet/report?start=2026-06-01&end=2026-07-01" \
  -H "X-API-Key: rah_live_abc123"

{
  "success": true,
  "report": {
    "profileId": "abc123",
    "rangeStart": "2026-06-01T00:00:00.000Z",
    "rangeEnd": "2026-07-01T00:00:00.000Z",
    "currency": "usd",
    "totals": {
      "paid": 42000,
      "inEscrow": 15000,
      "pendingRelease": 5000,
      "settled": 37000,
      "refunded": 2500
    },
    "byBounty": [
      {
        "bountyId": "bnty_1",
        "funded": 15000,
        "settled": 12000,
        "refunded": 0,
        "escrowCount": 3
      }
    ],
    "byHuman": [
      {
        "humanId": "hum_1",
        "humanName": "Jane D.",
        "paid": 12000,
        "escrowCount": 2
      }
    ]
  }
}

{
  "success": true,
  "controls": {
    "lowBalanceThresholdCents": 5000,
    "spendingCapPerBountyCents": 50000,
    "spendingCapRolling24hCents": 200000,
    "autoTopupEnabled": true,
    "autoTopupFloorCents": 2000,
    "autoTopupTargetCents": 20000,
    "autoTopupMaxPerDayCents": 100000
  }
}

curl -X PATCH https://rentahuman.ai/api/wallet/controls \
  -H "X-API-Key: rah_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "lowBalanceThresholdCents": 5000,
    "autoTopupEnabled": true,
    "autoTopupFloorCents": 2000,
    "autoTopupTargetCents": 20000,
    "autoTopupMaxPerDayCents": 100000
  }'

{
  "success": true,
  "controls": {
    "lowBalanceThresholdCents": 5000,
    "spendingCapPerBountyCents": null,
    "spendingCapRolling24hCents": null,
    "autoTopupEnabled": true,
    "autoTopupFloorCents": 2000,
    "autoTopupTargetCents": 20000,
    "autoTopupMaxPerDayCents": 100000
  }
}

curl -X POST https://rentahuman.ai/api/payment-links \
  -H "X-API-Key: rah_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 35,
    "description": "Laundry pickup and folding",
    "payerEmail": "[email protected]"
  }'

{
  "success": true,
  "paymentLinkId": "plink_abc123",
  "checkoutUrl": "https://rentahuman.ai/c/a3k7mn9pqr",
  "amount": 35,
  "amountCents": 3500,
  "status": "pending",
  "expiresAt": "2026-05-18T18:30:00.000Z"
}

{
  "success": true,
  "paymentLink": {
    "paymentLinkId": "plink_abc123",
    "amountCents": 3500,
    "currency": "usd",
    "status": "paid",
    "createdAt": "2026-05-18T18:00:00.000Z",
    "updatedAt": "2026-05-18T18:04:00.000Z",
    "expiresAt": "2026-05-18T18:30:00.000Z",
    "paidAt": "2026-05-18T18:04:00.000Z"
  }
}

curl -X POST https://rentahuman.ai/api/v1/qa/templates   -H "X-API-Key: rah_live_abc123"   -H "Content-Type: application/json"   -d '{
    "name": "Checkout QA",
    "targetUrl": "https://example.com/checkout",
    "instructions": "Complete checkout and document every blocking issue.",
    "testerStartMessage": "Use the shared test account [email protected] with password Test-only-123.",
    "cadence": "weekly",
    "budgetPerRunCents": 4500,
    "payPerTesterCents": 1500,
    "testerCount": 3,
    "submissionMode": "photo",
    "periodCapCents": 18000
  }'

{
  "success": true,
  "data": {
    "id": "template_01",
    "name": "Checkout QA",
    "cadence": "weekly",
    "budgetPerRunCents": 4500,
    "status": "active",
    "nextRunAt": "2026-07-16T18:00:00.000Z"
  },
  "warning": {
    "code": "insufficient_wallet_balance",
    "message": "Template created, but the wallet balance is below budgetPerRunCents. Deposit funds with POST /api/wallet/deposit before the run is due.",
    "balanceCents": 1000,
    "requiredCents": 4500,
    "depositEndpoint": "/api/wallet/deposit"
  }
}

curl https://rentahuman.ai/api/v1/qa/templates   -H "X-API-Key: rah_live_abc123"

{
  "success": true,
  "data": [
    {
      "id": "template_01",
      "name": "Checkout QA",
      "cadence": "weekly",
      "status": "active",
      "nextRunAt": "2026-07-16T18:00:00.000Z"
    }
  ]
}

curl -X PATCH https://rentahuman.ai/api/v1/qa/templates/template_01   -H "X-API-Key: rah_live_abc123"   -H "Content-Type: application/json"   -d '{"status":"paused"}'

{
  "success": true,
  "data": {
    "id": "template_01",
    "name": "Checkout QA",
    "status": "paused",
    "pausedReason": "user"
  }
}

curl "https://rentahuman.ai/api/v1/qa/runs?templateId=template_01"   -H "X-API-Key: rah_live_abc123"

{
  "success": true,
  "data": [
    {
      "id": "template_01_2026-07-16",
      "templateId": "template_01",
      "status": "reviewing",
      "reservedCents": 4500,
      "spentCents": 1500,
      "refundedCents": 0,
      "acceptedTesterCount": 3,
      "escalationCount": 1,
      "applicationEscalationCount": 0,
      "submissionEscalationCount": 0,
      "disputeEscalationCount": 1,
      "hasReport": false
    }
  ]
}

curl https://rentahuman.ai/api/v1/qa/runs/template_01_2026-07-16   -H "X-API-Key: rah_live_abc123"

{
  "success": true,
  "data": {
    "id": "template_01_2026-07-16",
    "templateId": "template_01",
    "status": "closed",
    "acceptedTesterCount": 3,
    "escalationCount": 1,
    "report": {
      "summary": "Checkout failed for two testers.",
      "findings": [],
      "diff": {
        "newFindingIds": [],
        "resolvedFindingIds": [],
        "stillOpenFindingIds": []
      },
      "testersAccepted": 3,
      "submissionsAccepted": 3,
      "submissionsRejected": 0,
      "generatedAt": "2026-07-17T18:00:00.000Z"
    },
    "escalations": [
      {
        "id": "application_01",
        "kind": "dispute",
        "reason": "Tester opened a payment or submission dispute that requires human review.",
        "createdAt": "2026-07-17T18:05:00.000Z"
      }
    ]
  }
}

curl -X PATCH https://rentahuman.ai/api/v1/qa/runs/run_01/escalations/application_01   -H "X-API-Key: rah_live_abc123"   -H "Content-Type: application/json"   -d '{"action":"accept"}'

{
  "success": true,
  "data": { "state": "pending" }
}