Employments

Suggest Edits

The Employment product gives you the ability to verify anyone's employment information in seconds. This can be used either as a primary source of information or during verification. Retrieving or verifying against information available in financial and government institutions provides you with reliable data, as well as access to other historical employment data included in their file.

This is especially useful for credit scoring, loans, and even recruitment. Verifiable employment information from government institutions and payroll platforms is a valuable data point that can help assess a person's credit worthiness.

Using Smile, anyone can share their gig account data with you, so you have information from alternative employment activities to form a clearer picture of their work and occupation. This is especially helpful when targeting the underbanked and gig economy workers.

This information can be used any number of ways:

  • verifying employment data provided by your customer
  • supplementing current data with information from gig platforms
  • assessing credit worthiness

Combined with our Identity and Incomes products, you can build a holistic view of your user, and determine appropriate financial services to offer and provide to them.

Sample Employment Data

Employment data is typically derived from government-mandated social security accounts and contains information on the user's employer(s) and the period of time the user has worked for the employer, based on their employer's remittance of mandated government services for the user.

[{
    "id": "e-123abc456def789abc123def456abc78",
    "startDate": "2022-07-01",
    "name": "Security",
    "description": null,
    "jobTitle": "Security Guard",
    "department": null,
    "employeeNumber": "EMP-123456",
    "employer": "ABC Corporation",
    "status": "Permanent",
    "endDate": "2022-07-31",
    "metadata": {
        "createdAt": "2022-09-01T01:44:18Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "abccorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    }
}, {
    "id": "e-123abc456def789abc123def456abc78",
    "startDate": "2022-06-01",
    "name": "Security",
    "description": null,
    "jobTitle": "Security Guard",
    "department": null,
    "employeeNumber": "CDE-98765",
    "employer": "CDE Corporation",
    "status": "Permanent",
    "endDate": "2022-06-30",
    "metadata": {
        "createdAt": "2022-09-01T01:44:18Z",
        "sourceId": "a-123abc456def789abc123def456abc78",
        "sourceType": "ACCOUNT",
        "userId": "tenantId-123abc456def789abc123def456abc78",
        "providerId": "cdecorp",
        "accountId": "a-123abc456def789abc123def456abc78"
    }
}]

Fallback Methods

If the sources your user provides are not enough, you can also make use of Smile's Archive API to retrieve a user-uploaded payslip document.

Testing Employment

Employment can be tested in Smile API's Sandbox mode without the need to contact Smile API. See Testing in Sandbox mode for more information. In order to test against live items in Production mode, book a call with us to request access for your account.

Next Steps

Updated 11 months ago