---
title: "Get Employment"
method: GET
path: "/employments/{id}"
tags: ["Employments"]
---

# Get Employment

`GET /employments/{id}`

Get a user's employment by ID.

## Response `200`

OK

- EmploymentGetResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` Employment — The stored employment information of the user from an employment data provider.
    - `id` string, required — Unique ID of this object
    - `name` string, nullable — Work performed
    - `description` string, nullable — Description of work performed
    - `jobTitle` string, nullable — Job title
    - `department` string, nullable — Department or organization in place of employment
    - `employeeNumber` string, nullable — Employee number in the employment data provider
    - `employerNumber` string, nullable — Employer number in the employment data provider
    - `employer` string, nullable — Employer name
    - `status` string, nullable — Status of employment
    - `startDate` string, date, required — Start date
    - `endDate` string, date, nullable — End date
    - `reportedDate` string, date, nullable — Reported date
    - `metadata` ObjectReferenceMetadata, required — Metadata related to account-specific data
      - `itemCreatedAt` string, date-time, required — Date and time
      - `createdAt` string, date-time, required — Date and time
      - `accountId` string — The accountId of this object
      - `sourceId` string, required — The ACCOUNT or ARCHIVE ID associated with this object
      - `sourceType` 'ACCOUNT' | 'UPLOAD' | 'ARCHIVE' | 'SOCIAL_SECURITY', nullable, required — Source Type
      - `userId` string, required — The user ID associated with this object
      - `providerId` string, required — The provider ID associated with this object

---

[API](https://skmtc.dev/smileapi/apis/smile-api.md) · [All operations](https://skmtc.dev/smileapi/apis/smile-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smileapi/smile-api/revisions/a4930eb49f4d/schema)