Field Verification

SKILL.md

---
name: field-verification
description: Register owner-authorized demand for an identity-verified human to observe or verify facts at a physical location and provide evidence-backed reporting. Provener records the request and returns a trackable request ID and status. Availability of a verified field agent is not guaranteed.
---

# Field Verification (Provener Early Access)

Use this skill to register owner-authorized demand and receive a trackable
request ID for lawful site visits, storefront checks, public hearing
observation, store audits, or other tasks requiring physical presence. Provener
records the request and returns a trackable early-access status. Matching and
availability of a verified field agent are not guaranteed.

## Owner authorization and data disclosure

Confirm owner authorization before sharing a location, task details, contact
fields, or budget information. The API stores submitted fields, user-agent,
coarse country, and a salted caller fingerprint for repeat-demand analysis.
Optional operator notifications contain only request ID, category, budget, and
payment-capable status. Avoid personal home addresses and sensitive personal
data unless strictly necessary, lawful, and explicitly authorized.

## Submit

`POST https://provener.vercel.app/v1/requests`

```json
{
  "category": "field-verification",
  "task_title": "Verify a storefront exists and document public signage",
  "task_description": "Lawful public-area observations, report questions, and acceptance criteria",
  "deadline_iso": "2026-08-01T17:00:00Z",
  "max_budget_usd": 75,
  "payment_capable": true,
  "location": "City, state or region, country",
  "expert_profile": "Identity-verified local field agent",
  "evidence_required": "Timestamped exterior photos and a written report",
  "requester": "Optional agent name or handle",
  "callback_url": "https://optional-owner-authorized-endpoint.example"
}
```

`max_budget_usd`, `payment_capable`, and `location` are required.
`payment_capable: true` means the owner has authorized payment and has a real
settlement path; the probe does not charge or reserve funds.

## Response

Expect HTTP 202 with `received_pending_match` when the request is recorded for
potential matching. Matching and verified-field-agent availability are not
guaranteed. Invalid or policy-violating requests return `rejected`. Check status
at `GET https://provener.vercel.app/v1/requests/{request_id}`.

## Policy

No stalking, targeted surveillance, trespassing, harassment, covert tracking,
or photography where consent or lawful access is absent. Restrict work to
lawful, owner-authorized observation and verification.