Verify People Employment

Start a background job to verify people still work at their associated companies.

Uses live-fetch to confirm current employment. People confirmed as departed are removed along with all dependent records.

Flow:

1. Call this endpoint with people_ids → receive job_id
2. Poll GET /api/v1/people/verify-job/{job_id} every 3-5 seconds
3. When status is "completed", the result field contains verification outcomes

Credit costs:

• Credits are charged per person found in the workspace

Example request:

{
  "people_ids": [101, 102, 103]
}

Error codes:

• 422 - Empty people_ids or exceeds max limit

POST /api/v1/people/verify

Verify People Employment

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/people/verify \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "people_ids": [
    123
  ]
}
'

200

{
  "job_id": "<string>",
  "status": "pending",
  "message": "<string>",
  "total_people": 123
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

Request to start a people verification job.

people_ids · integer[] · required

People IDs to verify against their associated companies (max 500 per request)

Required array length: 1 - 500 elements

Response

200

application/json

Successful Response

Response when a people verification job is created.

job_id · string · required

Unique job ID for polling status via GET /api/v1/people/verify-job/{job_id}

status · string · default: pending · required

Job status - always 'pending' at creation

message · string · required

Human-readable status message

total_people · integer · required

Number of people queued for verification