Workers API

The Workers API lets you search for verified workers near a location and retrieve worker profiles. Only workers who have completed KYC verification and enabled payouts appear in search results.

Base path: /v1/workers

---

Search Workers

GET /v1/workers/search

Search for verified workers near a geographic location. Results are sorted by distance from the specified coordinates.

Query Parameters

Parameter	Type	Required	Default	Description
latitude	number	Yes	--	Center latitude (-90 to 90)
longitude	number	Yes	--	Center longitude (-180 to 180)
radius_miles	number	No	10	Search radius in miles (max 50)
skills	string[]	No	--	Filter by required skills (comma-separated)
limit	integer	No	20	Results per page (max 100)
offset	integer	No	0	Number of results to skip

Example Request

curl "https://api.workfunder.com/v1/workers/search?latitude=40.6782&longitude=-73.9442&radius_miles=5&skills=photography&limit=10" \
  -H "Authorization: Bearer wf_live_your_key"

Example Response

{
  "data": [
    {
      "id": "w1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4",
      "first_name": "Marcus",
      "last_name": "T.",
      "city": "Brooklyn",
      "state": "NY",
      "skills": ["photography", "data_collection", "retail_audit"],
      "hourly_rate_cents": 2500,
      "reputation_score": 92,
      "distance_meters": 1287
    },
    {
      "id": "w2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5",
      "first_name": "Sarah",
      "last_name": "M.",
      "city": "Brooklyn",
      "state": "NY",
      "skills": ["photography", "mystery_shopping"],
      "hourly_rate_cents": 3000,
      "reputation_score": 88,
      "distance_meters": 3701
    }
  ],
  "meta": {
    "total": 2,
    "limit": 10,
    "offset": 0
  }
}

Filtering by Skills

Pass multiple skills as comma-separated values. Workers must have at least one of the specified skills to be included:

curl "https://api.workfunder.com/v1/workers/search?latitude=41.8781&longitude=-87.6298&skills=photography,inspection&limit=20" \
  -H "Authorization: Bearer wf_live_your_key"

Response Fields

Field	Type	Description
id	string	Worker ID
first_name	string	Worker's first name
last_name	string	Last initial only (privacy)
city	string	Worker's city
state	string	Worker's state
skills	string[]	Worker's registered skills
hourly_rate_cents	integer|null	Worker's preferred hourly rate in cents, or null if per-task only
reputation_score	number	Reputation score (0-100), or null if fewer than 5 completed tasks
distance_meters	integer	Distance from the search coordinates in meters

info

Only verified workers appear in search results. Workers must have completed KYC verification (kyc_status: "verified") and enabled payouts (payout_enabled: true) to be discoverable.

---

Get Worker

GET /v1/workers/:id

Retrieve a worker's public profile by ID.

Path Parameters

Parameter	Type	Description
id	string	The worker ID

Example Request

curl https://api.workfunder.com/v1/workers/w1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4 \
  -H "Authorization: Bearer wf_live_your_key"

Example Response

{
  "id": "w1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4",
  "first_name": "Marcus",
  "last_name": "T.",
  "city": "Brooklyn",
  "state": "NY",
  "skills": ["photography", "data_collection", "retail_audit"],
  "hourly_rate_cents": 2500,
  "reputation_score": 92
}

Errors

Code	Status	Description
WORKER_NOT_FOUND	404	Worker does not exist or is not verified

info

The worker profile returned via the API only includes public information. Private details like email, phone number, exact coordinates, and financial information are never exposed.