# Income & Employment

## Get income summary

 - [POST /v3/services/get_income_summary](https://docs.measureone.com/api/openapi_3.2/openapi/income-and-employment/paths/~1v3~1services~1get_income_summary/post.md): Retrieves a summary of an Individual's income based on the income related Items, including salary and other income related information. 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: User-submitted paystub with bank account check|
  |MIE_VF_USP_NO_BAC|Verification method: User-submitted paystub without bank account check|
  |MIE_VF_USW2|Verification method: User-submitted W-2|
  |MIE_VF_US1099B| Verification method: User-submitted 1099-B|
  |MIE_VF_US1099OID| Verification method: User-submitted 1099-OID|
  |MIE_VF_US1099DIV| Verification method: User-submitted 1099-DIV|
  |MIE_VF_US1099INT| Verification method: User-submitted 1099-INT|
  |MIE_VF_US1099CONSOLIDATED| Verification method: User-submitted 1099-CONSOLIDATED|
  |MIE_VF_DPC_USP|Verification method: Direct payroll account connection and one or more User-submitted Paystub|
  |MIE_VF_DPC_USW2|Verification method: Direct payroll account connection and User-submitted W-2|
  |MIE_VF_USP_USW2|Verification method: User-submitted one or more Paystub and W-2|
  |MIE_VF_W2|Verification method: W-2 reported income is the wages, tips and other comp. (box 1) as reported on the W-2|
  |MIE_ERNG_1099INT|Interest income computed using data available on 1099-INT|
  |MIE_ERNG_1099DIV|Dividend income computed using data available on 1099-DIV|
  |MIE_ERNG_1099B|Investment income computed using data available on 1099-B|
  |MIE_ERNG_1099OID|Interest income computed using data available on 1099-OID|
  |MIE_ERNG_1099MISC|Rental income is Rents (box 1) as reported on 1099-MISC|
  |MIE_ERNG_1099MISC|Royalty income is Royalties (box 2) as reported on 1099-MISC|
  |MIE_ERNG_1099MISC|Other income is Other Income (box 3) as reported on 1099-MISC|
  |MIE_VF_US_EDR|Verification method: User-submitted THE WORK NUMBER Employment Data Report|
  |MIE_VF_UCB|Verification method: User-connected bank account|
  |MIE_DRVD_EIN|Employment Identification Number (EIN) derived from W-2|
  |MIE_NI_BEM|Net income on Paystub matches with a corresponding entry in the bank statement|
  |MIE_NI_NO_BEM|Net income on Paystub does not matches with a corresponding entry in the bank statement|
  |MIE_NID_BEM|Net income on Paystub matches with a corresponding entry in the bank statement (Deposit Split)|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive earnings|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive yearly earnings|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive an EIN|


## Get employment summary

 - [POST /v3/services/get_employment_summary](https://docs.measureone.com/api/openapi_3.2/openapi/income-and-employment/paths/~1v3~1services~1get_employment_summary/post.md): 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|


## Get income employment details (VOIE)

 - [POST /v3/services/get_income_employment_details](https://docs.measureone.com/api/openapi_3.2/openapi/income-and-employment/paths/~1v3~1services~1get_income_employment_details/post.md): Retrieves details of an Individual's income and employment based on employment/income 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: User-submitted paystub with bank account check|
  |MIE_VF_USP_NO_BAC|Verification method: User-submitted paystub without bank account check|
  |MIE_VF_US_EDR|Verification method: User-submitted THE WORK NUMBER Employment Data Report|
  |MIE_VF_USW2|Verification method: User-submitted W-2|
  |MIE_VF_US1099B| Verification method: User-submitted 1099-B|
  |MIE_VF_US1099OID| Verification method: User-submitted 1099-OID|
  |MIE_VF_US1099DIV| Verification method: User-submitted 1099-DIV|
  |MIE_VF_US1099INT| Verification method: User-submitted 1099-INT|
  |MIE_VF_US1099CONSOLIDATED| Verification method: User-submitted 1099-CONSOLIDATED|
  |MIE_VF_DPC_USP|Verification method: Direct payroll account connection and one or more User-submitted Paystub|
  |MIE_VF_DPC_USW2|Verification method: Direct payroll account connection and User-submitted W-2|
  |MIE_VF_USP_USW2|Verification method: User-submitted one or more Paystub and W-2|
  |MIE_VF_W2|Verification method: W-2 reported income is the wages, tips and other comp. (box 1) as reported on the W-2|
  |MIE_ERNG_1099INT|Interest income computed using data available on 1099-INT|
  |MIE_ERNG_1099DIV|Dividend income computed using data available on 1099-DIV|
  |MIE_ERNG_1099B|Investment income computed using data available on 1099-B|
  |MIE_ERNG_1099OID|Interest income computed using data available on 1099-OID|
  |MIE_ERNG_1099MISC|Rental income is Rents (box 1) as reported on 1099-MISC|
  |MIE_ERNG_1099MISC|Royalty income is Royalties (box 2) as reported on 1099-MISC|
  |MIE_ERNG_1099MISC|Other income is Other Income (box 3) as reported on 1099-MISC|
  |MIE_VF_UCB|Verification method: User-connected bank account|
  |MIE_DA_ESD|Employment start date directly available in source data|
  |MIE_DRVD_ESD|Employment start date derived earliest available paystub|
  |MIE_DRVD_EIN|Employment Identification Number (EIN) derived from W-2|
  |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_NI_BEM|Net income on Paystub matches with a corresponding entry in the bank statement|
  |MIE_NI_NO_BEM|Net income on Paystub does not matches with a corresponding entry in the bank statement|
  |MIE_NID_BEM|Net income on Paystub matches with a corresponding entry in the bank statement (Deposit Split)|
  |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|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive earnings|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive yearly earnings|
  |MIE_INSUFFICIENT_DATA|Insufficient information to derive an EIN|