Predict job change

Authenticated with your x-api-key. See Authentication.

How it works

Pass a profile id — the same id a search result carries — to get its Next Move Signal: a 0.0–1.0 likelihood that the person is about to change role, plus the contributing factors behind it.

The signal is precision-first — it only fires on strong evidence. It is published above a confidence floor, so a profile either carries a high-confidence score or none at all; the tool never returns a low-confidence guess. When no score is held the call returns a 200 with has_prediction: false and is charged `0`. Read has_prediction first: true carries a score; false is a complete, definitive answer — not a failure — and retrying it will not change the result.

A 404 profile_not_found means no such profile — a different thing from a profile that simply has no score.

Request

GET /v1/profiles/{id}/job-change
Host: search-api.xverum.com
x-api-key: XVERUM-API-KEY

Path parameter

Example

curl "https://search-api.xverum.com/v1/profiles/a1b2c3d4/job-change" \
  -H "x-api-key: XVERUM-API-KEY"

Response — 200 OK

signal_date records when the evidence was seen, not when the score was last refreshed; the signal is re-scored regularly, so an older signal_date does not make a live score stale.

reasoning is the scoring model's own, versioned vocabulary, passed through unmodelled — treat each entry as opaque and do not depend on a fixed set of keys.

Example response — prediction held

{
  "has_prediction": true,
  "score": 0.82,
  "signal_date": "2026-08-19",
  "reasoning": [
    { "category": "professional_presentation", "intensity": "high", "weight": 0.58, "rank": 1 },
    { "category": "skills_and_networking", "intensity": "moderate", "weight": 0.27, "rank": 2 },
    { "category": "career_activity", "intensity": "low", "weight": 0.15, "rank": 3 }
  ],
  "credits_used": 10,
  "credits_remaining": 4990,
  "request_id": "1a2b3c4d5e6f7081"
}

Example response — no prediction held

{
  "has_prediction": false,
  "score": null,
  "signal_date": null,
  "reasoning": [],
  "credits_used": 0,
  "credits_remaining": 5000,
  "request_id": "1a2b3c4d5e6f7081"
}

Billing

A delivered prediction costs 10 credits, echoed as credits_used. When no prediction is held the call is free (credits_used: 0) — you only pay for a delivered score. The charge is deduped per (api-key, id) within a short window, and separately from a profile fetch of the same person.

A caller with a zero balance is still refused with 402 before the read, even where the answer would have turned out free.

Errors

All /v1 errors use the structured envelope (see Authentication):

{
  "error": {
    "code": "profile_not_found",
    "message": "No profile for id 'a1b2c3d4'.",
    "request_id": "1a2b3c4d5e6f7081"
  }
}