Poll Enrich Account with People Job

Poll the status of a fast people enrichment job.

Returns the current status and, when completed, the list of discovered people.

Status values:

• pending - Job created, not yet started
• running - Discovery in progress
• completed - All done; result contains discovered people
• failed - Job failed; check error_message

Polling recommendation: Every 2-3 seconds. Typically completes in 1-5 seconds.

Post completion, this API returns the people ids of the discovered people. Use the Get People Endpoint /api/v1/people/batch to get the people details.

GET /api/v1/enrich/fast-people-enrichment/{job_id}

Poll Enrich Account with People Job

cURL

curl --request GET \
  --url https://api.openfunnel.dev/api/v1/enrich/fast-people-enrichment/{job_id} \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>'

200

{
  "job_id": "<string>",
  "status": "<string>",
  "progress": {
    "total_found": 0,
    "total_stored": 0,
    "credits_used": 0
  },
  "account_id": 123,
  "people_ids": [
    123
  ],
  "audience_url": "<string>",
  "error_message": "<string>"
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Path Parameters

job_id · string · required

Response

200

application/json

Successful Response

Response from polling a fast people discovery job.

Status values:

• pending - Job created, not yet started
• running - Discovery in progress
• completed - All done; result contains discovered people
• failed - Job failed; check error_message

Polling recommendation: Every 2-3 seconds. Typical discovery completes in 1-5 seconds.

job_id · string · required

Job ID

status · string · required

'pending', 'running', 'completed', or 'failed'

progress · FastPeopleProgress · object

Progress info - available when status is 'running' or 'completed'

Show child attributes

account_id · integer | null

Account ID that was enriched

people_ids · integer[] | null

IDs of discovered people - available when status is 'completed'. Use GET /api/v1/people/batch to fetch full details.

audience_url · string | null

Audience URL if an audience was created

error_message · string | null

Error details - present only when status is 'failed'