`JobV2CurrentEmployment`¶

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

Schema¶

A JobV2CurrentEmployment object has three properties:

company: JobV2Company

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

source: JobV2Source optional

See Source of an attribute for more details.

title: string

The presumed current employer of the given person.

Example: "ACME Broadcasting Corp"

verification: JobV2CompanyVerification read-only optional

Verification of current employer by Modigie.

title: string optional

The name of the current employer of the given person as verified by Modigie.

Example: "ACME Broadcasting Corp"

position: JobV2Position optional

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

source: JobV2Source optional

See Source of an attribute for more details.

title

The presumed job title of the given person at the target company.

Example: "VP EMEA Operations"

verification read-only optional

Verification of job title by Modigie.

title: string optional

The current job title of the given person as verified by Modigie.

Example: "VP EMEA Operations"

employmentEnd: JobV2EmploymentEnd read-only optional

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 month in different formats.

Tip

For programmatic use we recommend to use the iso8601Format property.

Note

payload.employment.employmentEnd is only available when events.verifyEmployment.code: changed, i.e. the person left the target company.

iso8601Format: string

ISO 8601 format of the calendar month.

Example: "2023-01"

localeAbbrevFormat: string

Localized abbreviated format of the calendar month. The value may differ based on the request language, settings of the current user, or other configurations. Your application can use this format when presenting to users, e.g. in a user interface.

Not recommended for programmatic use!

Example: "Jan, 2023"

localeFormat: string

Localized long format of the calendar month. The value may differ based on the request language, settings of the current user, or other configurations. Your application can use this format when presenting to users, e.g. in a user interface.

Not recommended for programmatic use!

Example: "January, 2023"

localeNumberFormat: string

Localized number format of the calendar month. The value may differ based on the request language, settings of the current user, or other configurations. Your application can use this format when presenting to users, e.g. in a user interface.

Not recommended for programmatic use!

Example: "01/2023"

Examples¶

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"
        }
      }
    },
    ...
  },
  ...
}

Person elsewhere¶

Public records for this person do not show any history at the target company. However, Modigie confidently identified their current employment.

This can also be caused by failed name matches or missing links between companies, brands, departments, and/or subsidiaries.

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"
        }
      }
    },
    ...
  },
  ...
}

For events.verifyEmployment: verified_elsewhere the response will not include payload.employment.employmentEnd.

job-response.json

{
  "status": "completed",
  "events": {
    "verifyEmployment": {
      "code": "verified_elsewhere"
    },
    ...
  },
  "payload": {
    "employment": {
      "company": {
        "title": "Acme Inc.",
        "source": {
          "objectSystem": null,
          "objectType": null,
          "objectId": "personA",
          "propertyName": "company"
        },
        "verification": {
          "title": "Foo Corporation"
        }
      },
      "employmentEnd": null,
      "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
      }
    },
    ...
  },
  ...
}

JobV2CurrentEmployment¶

Schema¶

Examples¶

Person at target company¶

Person left target company¶

Person elsewhere¶

Employment unverified¶

`JobV2CurrentEmployment`¶