Job

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/recruitmcp-com/json-schema/recruitmcp-com-job-schema.json",
  "title": "Job",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/recruitmcp-com-openapi.json#/components/schemas/Job",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "object": {
      "type": "string",
      "enum": [
        "job"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "people_fetch"
      ]
    },
    "job_id": {
      "type": "string",
      "description": "Same as id."
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "parked",
        "completed",
        "failed"
      ]
    },
    "poll_url": {
      "type": "string",
      "description": "Path of GET /v1/jobs/{job_id}. Poll it every few seconds until status is completed or failed."
    },
    "credits_charged": {
      "type": "number",
      "description": "Credits the ledger charged for this job, the same number as result.cost.credits once completed. 0 until the job completes. The call that queued the job is charged when it completes."
    },
    "progress": {
      "type": "object",
      "properties": {
        "done": {
          "type": "integer"
        },
        "total": {
          "type": "integer"
        }
      }
    },
    "error": {
      "type": [
        "string",
        "null"
      ]
    },
    "result": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Profile"
          }
        },
        "not_found": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "cost": {
          "$ref": "#/$defs/Cost"
        }
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "id",
    "object",
    "status"
  ],
  "$defs": {
    "Cost": {
      "type": "object",
      "properties": {
        "credits": {
          "type": "integer",
          "description": "Credits charged by this call. Whole credits. 0 on an idempotent replay, where the body also has replayed: true and the header Idempotent-Replayed: true."
        },
        "cached_items": {
          "type": "integer",
          "description": "Items read from cache. On a replay, the value of the first response."
        },
        "live_items": {
          "type": "integer",
          "description": "Items fetched live by this call. 0 on a replay."
        },
        "upstream_calls": {
          "type": "integer",
          "description": "Index calls made by this call. 0 on a replay."
        }
      },
      "required": [
        "credits"
      ]
    },
    "Profile": {
      "type": "object",
      "properties": {
        "profile_id": {
          "type": "string",
          "description": "Search id. The same value search returned when both ids are known."
        },
        "alternate_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The other profile id for the same person. Null until the person has been enriched and both ids are known."
        },
        "full_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "photo": {
          "type": [
            "string",
            "null"
          ],
          "description": "Profile photo on this API, /v1/media/{token}. The token expires after 7 days; a later response signs a new one. Null when there is no photo."
        },
        "profile_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "public_identifier": {
          "type": [
            "string",
            "null"
          ]
        },
        "locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              }
            }
          }
        },
        "experience": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "position": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "company": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "started": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ended": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "location": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "company_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "company_industry": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "company_size": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "education": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "university": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "School profile URL."
              },
              "degree": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "faculty": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "started_year": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "ended_year": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          }
        },
        "skills": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "language": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "proficiency": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "certification": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "authority": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "open_to_work": {
          "type": "boolean"
        },
        "source": {
          "type": "string",
          "enum": [
            "profile_index",
            "contact_provider"
          ]
        },
        "fetched_at": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "profile_id",
        "source"
      ],
      "description": "The complete normalized profile: every field the index returns, in a stable shape. Email and phone are not included. education is part of this full profile."
    }
  }
}