---
title: "Get a job object"
method: GET
path: "/rest/jobs/{job_id}"
tags: ["Jobs"]
---

# Get a job object

`GET /rest/jobs/{job_id}`

## Request

- Base URL: `https://api.dailypay.com`
- URL: `https://api.dailypay.com/rest/jobs/{job_id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.dailypay.com/oauth2/token` scopes: `client:lookup`, `client:admin`
  - OAuth 2
    - Authorization code: `https://auth.dailypay.com/oauth2/auth`
    - Token URL: `https://auth.dailypay.com/oauth2/token` scopes: `user:read`
- TypeScript: <https://skmtc.dev/dailypay/apis/dailypay-rest-api/docs/rest/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns details about a person's employment.

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Returns the job object.

- JobData
  - `data` JobResource, required: A job describes the financial relationship between a person and an organization.
    - `type` 'jobs', required
    - `id` string, uuid, required
    - `attributes` JobAttributes, required
      - `external_identifiers` object: Holds unique identifiers for the employee or job defined by external organizations.
      - `first_name` string: The first name of the person as it is listed in their employee profile.
      - `last_name` string: The last name of the person as it is listed in their employee profile.
      - `activation_status` 'DEACTIVATED' | 'DEACTIVATION_PENDING' | 'ACTIVATION_REQUIRED' | 'ACTIVATION_UNDER_REVIEW' | 'ACTIVATED', required: Activation is the process of verifying that data is available for a Job, and that a person has verified their identity as the Person associated with the Job. Only paychecks from Jobs with `activated` status will contribute to an earnings balance account. To deactivate a job, update activation_status to `DEACTIVATED`.
      - `wage_rate` object, required
        - `amount` integer, required: A monetary quantity expressed in units of the lowest denomination in the associated currency. For example, `{ amount: 7250, currency: 'USD' }` resolves to $72.50.
        - `currency` string, required: A three-letter ISO 4217 currency code. For example, `USD` for US Dollars, `EUR` for Euros, or `JPY` for Japanese Yen.
        - `frequency` 'HOURLY' | 'WEEKLY' | 'BIWEEKLY' | 'TWICE_MONTHLY' | 'MONTHLY' | 'ANNUALLY', required
      - `title` string, nullable
      - `department` string, nullable
      - `location` string
      - `direct_deposit_status` 'SETUP_REQUIRED' | 'SETUP_PENDING' | 'SETUP_COMPLETE', required: - `SETUP_REQUIRED` Direct deposit is not set up for this Job. Update this resource's relationships to set up direct deposit. - `SETUP_PENDING` A system action is still pending. - `SETUP_COMPLETE` Direct deposit is set up for this Job.
    - `links` JobLinks, required
      - `self` string, uri, required
    - `relationships` JobRelationships, required: The relationships between the job and other resources, including the accounts to which paychecks from this job are deposited.
      - `person` PersonRelationship, required
        - `data` PersonIdentifier, required
          - `type` 'people', required
          - `id` string, uuid, required
      - `organization` OrganizationRelationship, required
        - `data` OrganizationIdentifier, required
          - `type` 'organizations', required
          - `id` string, uuid, required
      - `direct_deposit_default_depository` AccountRelationship
        - `data` AccountIdentifier, required
          - `type` 'accounts', required
          - `id` string, uuid, required
      - `direct_deposit_default_card` AccountRelationship
        - `data` AccountIdentifier, required
          - `type` 'accounts', required
          - `id` string, uuid, required

## Other responses

- `400`: Bad Request
- `401`: Invalid authentication credentials
- `403`: Not authorized to perform this operation
- `404`: Resource was not found
- `500`: Unexpected error occured

---

[API](https://skmtc.dev/dailypay/apis/dailypay-rest-api.md) - [All operations](https://skmtc.dev/dailypay/apis/dailypay-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dailypay/apis/dailypay-rest-api/revisions/24f4c159e842?raw)