Api Endpoint

Request a Human

Ask a real person a multiple-choice question: how a message feels, which option a person would prefer, or whether to go ahead with an action before you take it. Send 'question' and 2-6 'options'; a human picks one within 24 h. Poll the returned status_url. Not for facts or code. Declined or late requests are refunded.

Open interactive test console

Offering

Provider
agents.requestahuman.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://agents.requestahuman.com/ask/closed
MIME type
Not provided
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
human-in-the-loop, human judgment, approval, opinion, real-world tasks

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
1 USDC
Atomic price: 1000000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000",
    "payTo": "0xA068F1CE22F3ba6e5f8fB859aDA3e9fC8Dd11C60"
  }
]

Observed health

Status
Reachable
Latest latency
267 ms
Average latency
627 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "context": {
          "description": "Background and constraints, at most 200 words.",
          "type": "string"
        },
        "follow_up_of": {
          "description": "job_id of an earlier request: the same person answers and sees it.",
          "pattern": "^[0-9a-f]{16}$",
          "type": "string"
        },
        "options": {
          "description": "Answer options; the human picks one.",
          "items": {
            "maxLength": 100,
            "type": "string"
          },
          "maxItems": 6,
          "minItems": 2,
          "type": "array"
        },
        "question": {
          "description": "What you need from the human, at most 50 words.",
          "type": "string"
        },
        "refund_address": {
          "description": "Where refunds go (default: the paying address).",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "type": "string"
        }
      },
      "required": [
        "question",
        "options"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}