---
title: "Read a PII expansion job"
method: GET
path: "/v1/pii-expansion/jobs/{job_id}"
tags: ["pii-expansion"]
---

# Read a PII expansion job

`GET /v1/pii-expansion/jobs/{job_id}`

## Request

- Base URL: `https://api.ie.intrace.ai`
- URL: `https://api.ie.intrace.ai/v1/pii-expansion/jobs/{job_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Read the persisted job envelope for one PII-expansion run. When the job has completed, the `result` field contains a paginated page of normalized items controlled by the `limit` and `cursor` query parameters.

## Path parameters

- `job_id` string, required

## Query parameters

- `limit` integer
- `cursor` string, nullable

## Response `200`

Persisted job state with an optional paginated result page.

- JobEnvelopePiiExpansionResult
  - `capability` 'web_search' | 'pii_expansion' | 'social_profile_analysis', required
  - `completedAt` string, date-time, nullable
  - `error` ApiError: Standard API error payload.
    - `code` string, required
    - `message` string, required
    - `retryable` boolean
  - `expiresAt` string, date-time, nullable
  - `jobId` string, required
  - `progress` JobProgress: Progress metadata for long-running jobs.
    - `completedSteps` integer
    - `message` string, nullable
    - `stage` string, required
    - `totalSteps` integer, nullable
  - `result` PiiExpansionResult: Inline or final PII expansion result payload.
    - `capability` 'pii_expansion'
    - `items` PiiExpansionItem[]
      - `confidenceCategory` 'likely' | 'uncertain', required
      - `emails` string[]
      - `fullName` string, required
      - `id` string, required
      - `label` string, required
      - `matchRationale` string[]
      - `matchedInputs` MatchedInputReference[]
        - `inputType` 'name' | 'alias' | 'adverse_term' | 'keyword' | 'region' | 'email' | 'phone' | 'address' | 'username' | 'domain' | 'location' | 'employer' | 'social_url' | 'seed_url' | 'date_of_birth' | 'place_of_birth' | 'age' | 'gender' | 'drivers_license_state' | 'employment_role' | 'employment_department' | 'employment_location' | 'employment_status', required
        - `value` string, required
      - `normalizedAttributes` SanitizedNormalizedAttributes: Sanitized, connector-agnostic normalized attributes.
        - `addresses` string[]
        - `dates` string[]
        - `domains` string[]
        - `emails` string[]
        - `keywords` string[]
        - `locations` string[]
        - `names` string[]
        - `organizations` string[]
        - `phones` string[]
        - `profileHandles` string[]
        - `usernames` string[]
      - `phones` string[]
      - `riskFlags` string[]
      - `safeMetadata` object
      - `summary` string, required
      - `type` 'identity_candidate'
      - `usernames` string[]
    - `limit` integer
    - `nextCursor` string, nullable
    - `total` integer, nullable
    - `warnings` ApiWarning[]
      - `code` string, required
      - `message` string, required
  - `resultUrl` string, nullable
  - `startedAt` string, date-time, nullable
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'expired', required
  - `streamUrl` string, nullable
  - `submittedAt` string, date-time, required
  - `summary` JobSummary: Summary counters for a completed or running job.
    - `itemsFound` integer
    - `itemsReturned` integer
  - `warnings` ApiWarning[]
    - `code` string, required
    - `message` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-30** `14679f056943`: 1 warning, 1 info
  - added the new `social_profile_analysis` enum value to the `capability` response property for the response status `200`
  - removed the `social_match` enum value from the `capability` response property for the response status `200`
- **2026-05-30** `2f2558620f8a`: 1 breaking, 15 info
  - the `result/anyOf[subschema #1: PiiExpansionResult]/items/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `result/anyOf[subschema #1: PiiExpansionResult]/items/items/emails` to the response with the `200` status
  - added the optional property `result/anyOf[subschema #1: PiiExpansionResult]/items/items/matchRationale` to the response with the `200` status
  - added the optional property `result/anyOf[subschema #1: PiiExpansionResult]/items/items/matchedInputs` to the response with the `200` status
  - …12 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/intraceai/apis/intelligence-api/changes/v1/pii-expansion/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/intraceai/apis/intelligence-api.md) - [All operations](https://skmtc.dev/intraceai/apis/intelligence-api/llms.txt) - [OpenAPI document](https://skmtc.dev/intraceai/apis/intelligence-api/revisions/c0216eef7380?raw)
