# Get employment summary

Retrieves an summary of an Individual's employment based on employment related Items, including history and status. MeasureOne uses a set of heuristics to make a final determination. These heuristics are summarized in Reason Codes as detailed in the following table.

###  Reason Codes 
  |Code|Description|
  |--- |--- |
  |MIE_VF_DPC|Verification method: Direct payroll account connection|
  |MIE_VF_USP_BAC|Verification method: Individual-submitted paystub with bank account check|
  |MIE_VF_USP_NO_BAC|Verification method: Individual-submitted paystub without bank account check|
  |MIE_VF_US_EDR|Verification method: Individual-submitted THE WORK NUMBER Employment Data Report|
  |MIE_DA_ESD|Employment start date directly available in source data|
  |MIE_DRVD_ESD|Employment start date derived earliest available paystub|
  |MIE_DA_EED|Employment end date directly available in source data|
  |MIE_DRVD_EED|Employment end date derived from latest paystub|
  |MIE_DA_ROLE|Role information directly available in source data|
  |MIE_DA_ES|Employment status directly available in source data|
  |MIE_DRVD_ES|Employment status derived based on last pay date|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive employment status|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive employee role|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive employment start date|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive employment end date|


Endpoint: POST /v3/services/get_employment_summary
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Response 200 fields (application/json):

  - `individual` (object)

  - `individual.individual_id` (string)
    Unique ID of the Individual identified by MeasureOne

  - `individual.datasources` (array)

  - `datarequest_id` (string)
    Unique ID of the Data Request identified by MeasureOne

  - `service_context_id` (string)
    Unique ID of the service context identified by MeasureOne

  - `processing_status` (string)
    Processing status of the request.  - MeasureOne has finished processing of the request.  - We have received the request and system is acquiring the academic summary.
    Enum: "COMPLETED", "ACQUIRING"

  - `metadata` (object)
    metadata can be used for storing additional information in a structured format. metadata will be sent in webhooks and report response.

  - `employment_summary` (array)

  - `employment_summary.datasource` (object)
    Datasource details

  - `employment_summary.datasource.id` (string)
    MeasureOne datasource identifier

  - `employment_summary.datasource.type` (string)
    Type of datasource

  - `employment_summary.datasource.name` (string)
    Name of datasource

  - `employment_summary.datasource.provider_name` (string)
    Name of provider

  - `employment_summary.as_of_date` (number)
    Timestamp (milliseconds) when this record was generated

  - `employment_summary.employer` (object)
    employer information

  - `employment_summary.employer.name` (string)
    Name of the employer

  - `employment_summary.employer.phone_number` (string)
    Phone number of the employer

  - `employment_summary.employer.address` (object)

  - `employment_summary.employer.address.addr1` (string)

  - `employment_summary.employer.address.addr2` (string)

  - `employment_summary.employer.address.city` (string)

  - `employment_summary.employer.address.state_name` (string)

  - `employment_summary.employer.address.zipcode` (string)

  - `employment_summary.employer.address.country` (object)

  - `employment_summary.employer.address.country.name` (string)

  - `employment_summary.employee` (object)

  - `employment_summary.employee.service_details` (object)

  - `employment_summary.employee.service_details.employee_id` (string)
    employee_id provided by the employer

  - `employment_summary.employee.service_details.hire_date` (number)
    Hire date of the employee (timestamp in milliseconds)

  - `employment_summary.employee.service_details.status` (string)
    Status of employee with the employee
    Enum: "ACTIVE", "INACTIVE", "TERMINATED", "UNKNOWN"

  - `employment_summary.employee.service_details.salary` (number)
    Salary of the employee

  - `employment_summary.employee.service_details.salary_basis` (string)
    Basis of salary
    Enum: "HOURLY", "MONTHLY", "SEMI_MONTHLY", "WEEKLY", "BI_WEEKLY", "ANNUAL", "OTHER"

  - `employment_summary.employee.service_details.termination_date` (number)
    Termination date of the employee (timestamp in milliseconds)

  - `employment_summary.employee.service_details.termination_reason` (string)
    Termination reason

  - `employment_summary.employee.first_name` (string)
    First name of the employee

  - `employment_summary.employee.middle_name` (string)
    Middle name of the employee

  - `employment_summary.employee.last_name` (string)
    Last Name of the employee

  - `employment_summary.employee.email` (string)
    Email address of the employee

  - `employment_summary.employee.prefix` (string)
    Name prefix

  - `employment_summary.employee.suffix` (string)
    Name suffix

  - `employment_summary.employee.gender` (string)
    Gender of the employee

  - `employment_summary.employee.phone_number` (string)
    Phone number of the employee

  - `employment_summary.employee.date_of_birth` (string)
    Date of Birth of the employee in MM/DD/YYYY format.

  - `employment_summary.employee.ssn` (string)
    Social Security Number of the the employee

  - `employment_summary.roles` (array)
    Array of objects representing Employment of an Individual

  - `employment_summary.roles.position` (object)

  - `employment_summary.roles.position.name` (string)
    Name of the position

  - `employment_summary.roles.position.title` (string)
    Title of the position

  - `employment_summary.roles.type` (string)
    type of position
    Enum: "FULL_TIME", "PART_TIME", "CONTRACT", "OTHER"

  - `employment_summary.roles.supervisor` (string)
    Name of supervisor

  - `employment_summary.roles.interval` (object)

  - `employment_summary.roles.interval.start_date` (number)
    Start date timestamp (milliseconds) of the deployment

  - `employment_summary.roles.interval.end_date` (number)
    End date timestamp (milliseconds) of the deployment

  - `employment_summary.roles.location` (object)

  - `employment_summary.roles.location.name` (string)
    Location name

  - `employment_summary.roles.department` (string)
    Department during the deployment

  - `employment_summary.reason_codes` (array)
    Array of reason codes used for determining the employment summary. Helps developer understand how has the summary been derived.

  - `employment_summary.reason_codes.code` (string)
    Reason code applicable

  - `employment_summary.reason_codes.description` (string)
    Description providing details to understand how has the summary been derived.

  - `transaction_id` (string)
    Unique ID of this transaction.

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 404 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405

## Response 409 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `http_code` (number)
    Error status code
    Example: 409

  - `error_code` (string)
    MeasureOne Error code
    Example: "MULTIPLE_REPORT_INSTANCES"

  - `error_message` (string)
    Details of the error
    Example: "Multiple instances of the report EMPLOYMENT_SUMMARY found in the Data Request. Please provide params/metadata in request"

## Response 422 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

  - `reason_codes` (array)
    List of reason codes. Helps developer understand what error occurred during processing an item.

  - `reason_codes.code` (string)
    Reason code applicable
 |Reason Code|Description|
 |--- |--- |
 |UNSUPPORTED_FORMAT| The report could not be generated as the following items are of unsupported format.
 |UNPROCESSABLE_DOCUMENT_QUALITY| The report could not be generated as the following items are unprocessable.
 |PARTIAL_DOCUMENT| The report could not be generated as the following items are partial.
 |NO_ITEMS| The report could not be generated as there are no items for this Individual.

  - `reason_codes.description` (string)
    Description providing details to understand what error occurred during processing an item.

  - `reason_codes.context` (object)
    Context to understand where the reason code is applicable

  - `reason_codes.context.items` (array)
    List of Items where the reason code is applicable

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error