---
title: "List person finder jobs"
method: GET
path: "/v1/people-finder"
tags: ["People Finder"]
---

# List person finder jobs

`GET /v1/people-finder`

## Request

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

Return a paginated list of people-finder jobs for the current organization.

## Query parameters

- `status` 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled'
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of jobs

- object
  - `items` 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
  - `total` integer

---

[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)