logo

Paychecks

The paychecks endpoint provides detailed information about paychecks. You can retrieve individual paycheck details, including the person and job associated with the paycheck, its status, pay period, expected deposit date, total debited amount, withholdings, earnings, and currency.

Functionality: Retrieve specific paycheck details, including payee and job information, and monitor the status and financial details of each paycheck.

Get a Paycheck object

Returns details about a paycheck object.

Securityoauth_user_token
Request
path Parameters
paycheck_id
required
string <uuid>

Unique ID of the paycheck

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
header Parameters
DailyPay-API-Version
integer
Default: 3

The version of the DailyPay API to use for this request. If not provided, the latest version of the API will be used.

Accept
string
Default: application/vnd.api+json

The media type of the requested payload. This should be set to application/vnd.api+json to signify your client can receive responses in the JSON:API format. For more details, see https://jsonapi.org.

Enum: "application/vnd.api+json" "*/*"
Responses
200

Returns the paycheck object.

Response Schema: application/vnd.api+json
required
object (PaycheckResource)
type
required
string
Value: "paychecks"
id
required
string <uuid>
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
required
object (PaycheckAttributes)
status
required
string

A paycheck expected for an open pay period will have the status ESTIMATED. At the end of the pay period, the paycheck will begin PROCESSING. When it is sent, it will become IN_TRANSIT. Finally, once deposited in an account it will have the status DEPOSITED.

Enum: "ESTIMATED" "PROCESSING" "IN_TRANSIT" "DEPOSITED"
pay_period_ends_at
required
string <date-time>

An ISO 8601 timestamp denoting the ending day of a paycheck's pay period. For example, a pay period that ends during the day of March 15 will have a value of 2023-03-15T04:00:00Z.

Example: "2023-03-15T04:00:00Z"
pay_period_starts_at
required
string <date-time>

An ISO 8601 timestamp denoting the first day of a paycheck's pay period. For example, a pay period that starts during the day of March 15 will have a value of 2023-03-15T04:00:00Z.

Example: "2023-03-15T04:00:00Z"
deposit_expected_at
required
string <date-time>

An ISO 8601 timestamp denoting the day the paycheck is scheduled to be delivered.

Example: "2023-03-15T04:00:00Z"
total_debited
required
integer or null >= 0

The amount debited and settled from this paycheck prior to the end of the pay period. Debits are settled during a pay period in order to cover withdrawals from an earnings balance account. This amount is given as a monetary quantity expressed in units of the lowest denomination in the associated currency. For example, { total_debited: 7050 } with currency USD resolves to $70.50.

Example: 0
gross_earnings
required
integer

The total earnings for this paycheck before any deductions are applied. This amount is given as a monetary quantity expressed in units of the lowest denomination in the associated currency. For example, { gross_earnings: 55370 } with currency USD resolves to $553.70

Example: 0
employer_withholdings
required
integer or null

The amount withheld from this paycheck by the employer, usually for taxes. This amount is given as a monetary quantity expressed in units of the lowest denomination in the associated currency. For example, { withholdings: 5000 } with currency USD resolves to $50.00.

Example: 0
net_earnings
required
integer or null

The net earnings for the paycheck once settled given in a monetary quantity expressed in units of the lowest denomination in the associated currency. For example, { earnings: 50370 } with currency USD resolves to $503.70.

Example: 0
currency
required
string (Currency)

A three-letter ISO 4217 currency code. For example, USD for US Dollars, EUR for Euros, or JPY for Japanese Yen.

required
object (PaycheckLinks)
self
required
string <uri> (PaycheckLink)
required
object (PaycheckRelationships)
required
object (PersonRelationship)
required
object (JobRelationship)
400

Bad Request

401

Invalid authentication credentials

403

Not authorized to perform this operation

404

Resource was not found

500

Unexpected error occured

get/rest/paychecks/{paycheck_id}
Request samples 
curl -i -X GET \
  'https://api.dailypay.com/rest/paychecks/{paycheck_id}' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'DailyPay-API-Version: 3'
Response samples
application/vnd.api+json
{
  • "data": {
    • "type": "paychecks",
    • "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    • "attributes": {
      • "status": "ESTIMATED",
      • "pay_period_ends_at": "2023-03-15T04:00:00Z",
      • "pay_period_starts_at": "2023-03-15T04:00:00Z",
      • "deposit_expected_at": "2023-03-15T04:00:00Z",
      • "total_debited": 0,
      • "gross_earnings": 0,
      • "employer_withholdings": 0,
      • "net_earnings": 0,
      • "currency": "USD"
      },
    • "links": {},
    • "relationships": {
      • "person": {
        • "data": {
          • "type": "people",
          • "id": "3fa8f641-5717-4562-b3fc-2c963f66afa6"
          }
        },
      • "job": {
        • "data": {
          • "type": "jobs",
          • "id": "e9d84b0d-92ba-43c9-93bf-7c993313fa6f"
          }
        }
      }
    }
}

Get a list of paycheck objects

Returns a collection of paycheck objects. This object details a person's pay and pay period. See Filtering Paychecks for a description of filterable fields.

Securityoauth_user_token
Request
query Parameters
filter[job.id]
string

Limit the results to documents related to a specific job

filter[status]
string

Limit the results to paychecks with the specified status

Enum: "ESTIMATED" "PROCESSING" "IN_TRANSIT" "DEPOSITED"
filter[deposit_expected_at__gte]
string <date-time>

Limit the results to paychecks with deposit_expected_at greater than or equal to the specified date

Example: filter[deposit_expected_at__gte]=2023-03-15T04:00:00Z
filter[deposit_expected_at__lt]
string <date-time>

Limit the results to paychecks with deposit_expected_at less than the specified date

Example: filter[deposit_expected_at__lt]=2023-03-15T04:00:00Z
filter[pay_period_ends_at__gte]
string <date-time>

Limit the results to paychecks with pay_period_ends_at greater than or equal to the specified date

Example: filter[pay_period_ends_at__gte]=2023-03-15T04:00:00Z
filter[pay_period_ends_at__lt]
string <date-time>

Limit the results to paychecks with pay_period_ends_at less than the specified date

Example: filter[pay_period_ends_at__lt]=2023-03-15T04:00:00Z
filter[pay_period_starts_at__gte]
string <date-time>

Limit the results to paychecks with pay_period_starts_at greater than or equal to the specified date

Example: filter[pay_period_starts_at__gte]=2023-03-15T04:00:00Z
filter[pay_period_starts_at__lt]
string <date-time>

Limit the results to paychecks with pay_period_starts_at less than the specified date

Example: filter[pay_period_starts_at__lt]=2023-03-15T04:00:00Z
filter
string
Deprecated
Examples:
filter=job_id:"aa860051-c411-4709-9685-c1b716df611b"
filter=status:"DEPOSITED"
header Parameters
DailyPay-API-Version
integer
Default: 3

The version of the DailyPay API to use for this request. If not provided, the latest version of the API will be used.

Accept
string
Default: application/vnd.api+json

The media type of the requested payload. This should be set to application/vnd.api+json to signify your client can receive responses in the JSON:API format. For more details, see https://jsonapi.org.

Enum: "application/vnd.api+json" "*/*"
Responses
200

Returns the paycheck object.

Response Schema: application/vnd.api+json
required
Array of objects (PaycheckResource)
Array
type
required
string
Value: "paychecks"
id
required
string <uuid>
Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"
required
object (PaycheckAttributes)
required
object (PaycheckLinks)
required
object (PaycheckRelationships)
400

Bad Request

401

Invalid authentication credentials

403

Not authorized to perform this operation

500

Unexpected error occured

get/rest/paychecks
Request samples 
curl -i -X GET \
  'https://api.dailypay.com/rest/paychecks?filter%5Bjob.id%5D=string&filter%5Bstatus%5D=ESTIMATED&filter%5Bdeposit_expected_at__gte%5D=2023-03-15T04%3A00%3A00Z&filter%5Bdeposit_expected_at__lt%5D=2023-03-15T04%3A00%3A00Z&filter%5Bpay_period_ends_at__gte%5D=2023-03-15T04%3A00%3A00Z&filter%5Bpay_period_ends_at__lt%5D=2023-03-15T04%3A00%3A00Z&filter%5Bpay_period_starts_at__gte%5D=2023-03-15T04%3A00%3A00Z&filter%5Bpay_period_starts_at__lt%5D=2023-03-15T04%3A00%3A00Z&filter=string' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'DailyPay-API-Version: 3'
Response samples
application/vnd.api+json
{
  • "data": [
    • {
      • "type": "paychecks",
      • "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      • "attributes": {
        • "status": "ESTIMATED",
        • "pay_period_ends_at": "2023-03-15T04:00:00Z",
        • "pay_period_starts_at": "2023-03-15T04:00:00Z",
        • "deposit_expected_at": "2023-03-15T04:00:00Z",
        • "total_debited": 0,
        • "gross_earnings": 0,
        • "employer_withholdings": 0,
        • "net_earnings": 0,
        • "currency": "USD"
        },
      • "links": {},
      • "relationships": {
        • "person": {
          • "data": {
            }
          },
        • "job": {
          • "data": {
            }
          }
        }
      }
    ]
}
➔ Next to People