Current employment

Preview

This feature is not subject to our service terms. Pre-GA features are available as is and might have limited support.

The presumed current employment of the given person at the target company and optionally the verification of this information.

Schema

The job's payload.employment property is of type JobV2CurrentEmployment.

A JobV2CurrentEmployment object has four properties:

company: JobV2CurrentEmployment_company

The target company at which the person presumably works and optionally the verification of this information. Schema: JobV2CurrentEmployment_company

position: JobV2CurrentEmployment_jobTitle optional

The presumed job title of the given person at the target company and optionally the verification of this information. Schema: JobV2CurrentEmployment_jobTitle

employmentEnd: JobV2CurrentEmployment_employmentEnd read-only

If Modigie can verify that the given person worked at the target company in the past, this value may show the month when the person left the target company. In rare cases the time could be in the future. The property represents a calendar month based on ISO 8601. You can read the day in different formats. Schema: JobV2CurrentEmployment_employmentEnd

Example

Person at target company

Job requestJob response

job-request.json

{
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectId": "personA",
          "propertyName": "company"
        }
      },
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        }
      }
    },
    ...
  },
  ...
}

The response may include the verified current job title in payload.employment.position.verification.title.

job-response.json

{
  "status": "completed",
  "events": {
    "verifyEmployment": {
      "code": "verified"
    },
    ...
  },
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "company"
        },
        "verification": {
          "title": "ACME"
        }
      },
      "employmentEnd": null,
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        },
        "verification": {
          "title": "Senior VP Global Operations"
        }
      }
    },
    ...
  },
  ...
}

Person left target company

Job requestJob response

job-request.json

{
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectId": "personA",
          "propertyName": "company"
        }
      },
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        }
      }
    },
    ...
  },
  ...
}

If the person left the target company, the response will include the time when they left the company in payload.employment.employmentEnd. The value is available in different formats from which your application can pick.

job-response.json

{
  "status": "completed",
  "events": {
    "verifyEmployment": {
      "code": "changed"
    },
    ...
  },
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "company"
        },
        "verification": {
          "title": "Foo Corporation"
        }
      },
      "employmentEnd": {
        "iso8601Format": "2024-08",
        "localeAbbrevFormat": "Aug-2024",
        "localeFormat": "August 2024",
        "localeNumberFormat": "08 / 2024"
      },
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        },
        "verification": {
          "title": "Senior VP Global Operations"
        }
      }
    },
    ...
  },
  ...
}

Employment unverified

Job requestJob response

job-request.json

{
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectId": "personA",
          "propertyName": "company"
        }
      },
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        }
      }
    },
    ...
  },
  ...
}

If no employment verification is part of the job type, but your application still provided the values, or the employment verification failed, you will not receive verified employment information.

job-response.json

{
  "status": "completed",
  "events": {
    "verifyEmployment": {
      "code": "unable_to_verify"
    },
    ...
  },
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "company"
        },
        "verification": null
      },
      "employmentEnd": null,
      "position": {
        "title": "VP EMEA Operations",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "function"
        },
        "verification": null
      }
    },
    ...
  },
  ...
}

Schema: JobV2CurrentEmployment