Profiles

List profile fetch jobs

Changed on Oct 20, 2026

Scope: sourcing:read.

get/v1/jobs

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/jobs
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: sourcing:read)

Query parameters

status'queued' | 'running' | 'parked' | 'completed' | 'failed'

Only jobs in this status.

created_afterstring date-time

Only rows created after this time.

created_beforestring date-time

Only rows created before this time.

limitinteger

How many items to return. Default 25, at most 100.

cursorstring

next_cursor from the previous response. An invalid cursor is 400 invalid_request, message Invalid cursor.

Headers

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Response

Jobs, newest first.

object'list' required

next_cursorstring nullable required

Pass as cursor for the next page. Null on the last page.

has_moreboolean required

Example response

{
  "data": [
    {
      "id": "job_01J0JOB0EXAMPLE",
      "object": "job",
      "kind": "people_fetch",
      "job_id": "job_01J0JOB0EXAMPLE",
      "status": "completed",
      "poll_url": "/v1/jobs/job_01J0JOB0EXAMPLE",
      "credits_charged": 2,
      "progress": {
        "done": 1,
        "total": 1
      },
      "error": null,
      "result": {
        "data": [
          {
            "profile_id": "lead_8f2a1c_1",
            "full_name": "Ada Peeters",
            "headline": "Backend Engineer at Acme Robotics",
            "profile_url": "https://profiles.example.com/ada-peeters",
            "experience": [
              {
                "position": "Backend Engineer",
                "company": "Acme Robotics",
                "started": "2021-03",
                "current": true,
                "company_url": "https://companies.example.com/acme-robotics"
              }
            ],
            "skills": [
              "Go",
              "Kubernetes"
            ],
            "source": "profile_index",
            "fetched_at": "2026-10-13T09:00:00Z"
          }
        ],
        "not_found": [],
        "cost": {
          "credits": 2,
          "cached_items": 0,
          "live_items": 1,
          "upstream_calls": 1
        }
      },
      "created_at": "2026-10-13T09:00:00Z",
      "updated_at": "2026-10-13T09:00:04Z"
    }
  ]
}

Changes

Oct 20, 2026ad27b35513a6 Revision changes
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status

Operation history