---
title: "Get job status and results"
method: GET
path: "/v1/people-finder/{jobId}"
tags: ["People Finder"]
---

# Get job status and results

`GET /v1/people-finder/{jobId}`

## Request

- Base URL: `https://api.abm.dev`
- URL: `https://api.abm.dev/v1/people-finder/{jobId}`
- Auth: API key in header `X-API-Key`

Retrieve the current status, progress, and results (if complete) for a people-finder job.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Job details with results

- PersonFinderJob
  - `jobId` string, uuid
  - `status` 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled'
  - `companyName` string
  - `roles` string[]
  - `percentComplete` integer
  - `currentStep` string: Human-readable description of the current processing step
  - `createdAt` string, date-time
  - `completedAt` string, date-time
  - `result` object
    - `candidates` PersonFinderCandidate[]
      - `name` string
      - `title` string
      - `matchedRole` string: Which searched role this candidate matched
      - `confidence` number, float: Match confidence score (0-1)
      - `email` string, email
      - `linkedinUrl` string, uri
      - `location` string
      - `sources` string[]: Data sources that found this candidate
      - `hubspotContactId` string: HubSpot contact ID if created in CRM
      - `enrichmentJobId` integer: Enrichment job ID if enrich option was enabled
    - `rolesSearched` integer
    - `durationSeconds` number
  - `error` string: Error message if status is failed
  - `statusUrl` string, uri: URL to poll for status updates
  - `streamUrl` string, uri: URL for SSE progress stream

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/abm/apis/abm-dev-api.md) · [All operations](https://skmtc.dev/abm/apis/abm-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/abm/apis/abm-dev-api/revisions/970c68654961?raw)