Skip to content
HumanTaskAPI

Capability · address_verification

Verify a Physical Address Anywhere

Send a verified human to confirm a physical address, location details and visible evidence.

Evidence returnedExample

Address Verification · field capture

captured_at · location_confirmed

Structured checklist

required fields · exceptions

Task result object

capability: "address_verification"

Digital agents are strong at planning and data processing; address verification begins where those abilities stop. The service is designed to verify that a stated physical address can be located and that visible details match the requester’s description. Instead of opening a generic freelance project, the requester creates a specific task with acceptance criteria and a structured result.

When to Use Address Verification

The best address verification jobs are concrete enough that two independent workers would understand the same objective. Examples include confirm a business operates at a stated address; verify a delivery or pickup location before dispatch; check visible unit or building identifiers; or document entrance instructions for a remote operations team. These are not broad consulting assignments. They are observable field actions that can be accepted, completed and checked.

Define a Address Verification Request

A requester should provide normalized address, entity or recipient name, and expected signage or identifiers. It should also state allowed observation area, visit time, and evidence checklist. The instruction should separate facts the worker can observe from decisions the AI or business will make later. That distinction prevents a simple field task from quietly turning into specialist advice.

Required inputs

  • Normalized address
  • Entity or recipient name
  • Expected signage or identifiers
  • Allowed observation area
  • Visit time
  • Evidence checklist

Evidence That Makes the Result Useful

For address verification, a useful completion package may contain address-found status, entrance or signage photos where permitted, timestamp, location context, and structured notes on mismatches. The evidence schema should be selected before dispatch. A task that merely says “send proof” is weaker than one that specifies which files, fields and observations are mandatory. The receiving agent can then test completeness without interpreting a chat message.

Suggested result fields

  • Address-found status
  • Entrance or signage photos where permitted
  • Timestamp
  • Location context
  • Structured notes on mismatches

Failure Modes to Plan For

Real locations create exceptions that software APIs rarely face. In this capability, common examples are: multiple entrances share one address, unit numbers are not visible, the business name differs from the requester’s data, and the address exists but access is restricted. Those outcomes should be returned as explicit exception states rather than hidden inside a free-text note. An AI agent can then retry with new instructions, choose another location, widen the deadline or escalate to a specialist.

Exception examples

  • Multiple entrances share one address
  • Unit numbers are not visible
  • The business name differs from the requester’s data
  • The address exists but access is restricted

Example Workflow for an AI Agent

Consider this workflow: Before routing a courier, software can ask a local human to confirm the correct entrance and visible suite number instead of relying on an outdated map listing. The agent first decides that a physical check is necessary, then creates a address_verification task with the address, deadline and evidence fields. The worker accepts the job, completes only the permitted actions and submits the requested proof. After the result arrives, the software can validate required fields, store the media references and continue its original plan.

Who Uses Address Verification

Address Verification can support logistics, marketplaces, remote operations, property services and AI agents validating location data. These users have different business goals, but they share the same bottleneck: the missing fact or action exists offline. A reusable task definition lets them solve that bottleneck without maintaining a field team in every city.

API Shape for Address Verification

The machine-facing representation should be narrow. A address_verification request can carry a normalized location, human-readable instructions, a deadline, budget, required evidence and a client reference. The response should return a task identifier and lifecycle state. Follow-up operations should expose status and evidence without forcing the caller to scrape a dashboard. MCP can present the same operation as an agent tool; REST and OpenAPI can serve conventional application integrations.

Example task object

json · Example
{
  "capability": "address_verification",
  "location": {"address": "TARGET_ADDRESS"},
  "deadline": "ISO_8601",
  "instructions": "TASK-SPECIFIC_INSTRUCTIONS",
  "evidence_required": ["TASK_SPECIFIC_FIELDS"]
}

Launch a Address Verification Task

Start with one address verification request that has an unambiguous outcome. Define the location, deadline and proof first; then create the task through the web flow or the available developer interface. If the workflow repeats, promote the same evidence schema into a reusable integration.

What makes address verification different from a generic gig

The value is not simply that a person is available. The value is that the request is standardized enough for software to understand the expected result. For address verification, the schema should reflect the actual decision being supported: the agent needs evidence about verify that a stated physical address can be located and that visible details match the requester’s description. That makes the task easier to price, route, compare and audit than an open-ended message to a freelancer.

json · Example result shape
{
  "task_id": "tsk_example",
  "capability": "on_site_photos",
  "status": "evidence_submitted",
  "evidence": [
    { "type": "photo", "captured_at": "…", "location_confirmed": true }
  ],
  "exceptions": []
}

Frequently asked questions

What should a address verification request contain?

Include normalized address, entity or recipient name, expected signage or identifiers, and allowed observation area. Add the remaining task-specific fields when they affect access, proof or timing.

What does HumanTask API return for address verification?

A result can contain address-found status, entrance or signage photos where permitted, timestamp, and location context, plus explicit notes when the task cannot be completed as planned.

What can prevent a address verification task from completing?

Typical blockers include multiple entrances share one address, unit numbers are not visible, and the business name differs from the requester’s data. The worker should report the blocker rather than invent a successful result.

Can an AI agent create address verification programmatically?

Yes. The intended machine-facing capability is `address_verification`, using the same task object whether the caller comes through REST, OpenAPI or MCP.

When is address verification a poor fit?

It is a poor fit when the request is unsafe, requires unverified professional expertise, depends on private access that has not been arranged, or cannot be evaluated with observable evidence.

Next step

Put a human on it.

Describe the place, the action and the proof you need. The API and MCP integration are in developer preview.