--- title: "Worker Checks" method: GET path: "/workers/{workerId}/checks" tags: ["Payroll"] --- # Worker Checks `GET /workers/{workerId}/checks` ## Request - Base URL: `https://api.paychex.com` - URL: `https://api.paychex.com/workers/{workerId}/checks` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Get check(s) that are for a specific worker within a processed or unprocessed pay period. ## Path parameters - `workerId` string, required ## Query parameters - `payperiodid` string, required - `filterbyuserid` boolean ## Response `200` successful operation - object - `metadata` MetadataResource - `contentItemCount` integer - `pagination` PaginationMetadataResource - `offset` integer - `limit` integer - `itemCount` integer - `total` integer - `content` CheckResourceInternal1: Check resource - `workerId` string: The id assigned to the worker - `paycheckId` string: The id of a single check that a workers has. - `payPeriodId` string: The id for the unprocessed payperiod. - `checkCorrelationId` string: Id that you define which is used for error handling/responses. This is not required when sending a single check. - `blockAutoDistribution` true | false: This is used optionally for blocking the auto distribution of the earnings on the workers if they are setup for auto distribution. - `earnings` PayComponentResourceInternal1[]: The earnings to apply to the check.Each earning needs to define as one of the following:1 .payHours: Will use the default hourly rate defined on the worker to apply the hours against. 2. payHours and payRate: Will allow you to define the monetary rate that the hours will be applied against. 3. payHours and payRateId: Will allow you to define which workers predefined pay rate the hours will be applied against. 4. payUnits: Will use the default hourly rate defined on the worker to apply the units against. 5. payUnits and payRate: Will allow you to define the monetary rate that the units will be applied against. 6. payUnits and payRateId: Will allow you to define which workers predefined pay rate the units will be applied against. 7. payAmount: Will allow you to define straight monetary amount. - `componentId` string: The identifier of the pay component to add to the check. An overtime pay component can't be placed on a worker that is OT exempt. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `name` string: The name given to the pay component - `classificationType` string: The category that this component falls into. - `description` string - `effectOnPay` 'ADDITION' | 'ADDITION_WITH_IN_OUT' | 'EMPLOYER_INFORMATIONAL' | 'REDUCTION': The effect that the pay component will have on the check amount. - `startDate` string, date-time: The date that the pay component is able to be applied on a check. - `endDate` string, date-time: The date that the pay component is not available to be applied on a check moving forward. - `jobId` string: This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. - `laborAssignmentId` string: This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. - `payRateId` string: The rate identifier for the workers compensation - `payRate` string: The rate amount that will be applied for this component. Used in conjunction with Hours or Units. - `payHours` string: The number of hours that will be applied for this component. Used in conjunction with rate - `payUnits` string: The number of units that will be applied for this component. Used in conjunction with rate. - `payAmount` string: The flat amount to be applied for this component. Not used with Rate, Hours, or Units. - `organization` OrganizationResourceInternal1: The organization which the worker is part of. - `organizationId` string: The unique identifier associated with this organizations representation. - `name` string: The name of the organization. - `number` string: The number assigned to the organization. - `level` string: The level number within the organizational structures hierarchy. - `lineDate` string, date-time: This is used optionally for specifying a date that the earning was generated on. - `memoed` boolean: This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. - `deductions` PayComponentResourceInternal1[]: Deduction pay components on the check. - `componentId` string: The identifier of the pay component to add to the check. An overtime pay component can't be placed on a worker that is OT exempt. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `name` string: The name given to the pay component - `classificationType` string: The category that this component falls into. - `description` string - `effectOnPay` 'ADDITION' | 'ADDITION_WITH_IN_OUT' | 'EMPLOYER_INFORMATIONAL' | 'REDUCTION': The effect that the pay component will have on the check amount. - `startDate` string, date-time: The date that the pay component is able to be applied on a check. - `endDate` string, date-time: The date that the pay component is not available to be applied on a check moving forward. - `jobId` string: This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. - `laborAssignmentId` string: This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. - `payRateId` string: The rate identifier for the workers compensation - `payRate` string: The rate amount that will be applied for this component. Used in conjunction with Hours or Units. - `payHours` string: The number of hours that will be applied for this component. Used in conjunction with rate - `payUnits` string: The number of units that will be applied for this component. Used in conjunction with rate. - `payAmount` string: The flat amount to be applied for this component. Not used with Rate, Hours, or Units. - `organization` OrganizationResourceInternal1: The organization which the worker is part of. - `organizationId` string: The unique identifier associated with this organizations representation. - `name` string: The name of the organization. - `number` string: The number assigned to the organization. - `level` string: The level number within the organizational structures hierarchy. - `lineDate` string, date-time: This is used optionally for specifying a date that the earning was generated on. - `memoed` boolean: This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. - `informational` PayComponentResourceInternal1[]: Informational pay components on the check. - `componentId` string: The identifier of the pay component to add to the check. An overtime pay component can't be placed on a worker that is OT exempt. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `name` string: The name given to the pay component - `classificationType` string: The category that this component falls into. - `description` string - `effectOnPay` 'ADDITION' | 'ADDITION_WITH_IN_OUT' | 'EMPLOYER_INFORMATIONAL' | 'REDUCTION': The effect that the pay component will have on the check amount. - `startDate` string, date-time: The date that the pay component is able to be applied on a check. - `endDate` string, date-time: The date that the pay component is not available to be applied on a check moving forward. - `jobId` string: This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. - `laborAssignmentId` string: This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. - `payRateId` string: The rate identifier for the workers compensation - `payRate` string: The rate amount that will be applied for this component. Used in conjunction with Hours or Units. - `payHours` string: The number of hours that will be applied for this component. Used in conjunction with rate - `payUnits` string: The number of units that will be applied for this component. Used in conjunction with rate. - `payAmount` string: The flat amount to be applied for this component. Not used with Rate, Hours, or Units. - `organization` OrganizationResourceInternal1: The organization which the worker is part of. - `organizationId` string: The unique identifier associated with this organizations representation. - `name` string: The name of the organization. - `number` string: The number assigned to the organization. - `level` string: The level number within the organizational structures hierarchy. - `lineDate` string, date-time: This is used optionally for specifying a date that the earning was generated on. - `memoed` boolean: This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. - `taxes` PayComponentResourceInternal1[]: Tax pay components on the check. - `componentId` string: The identifier of the pay component to add to the check. An overtime pay component can't be placed on a worker that is OT exempt. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `name` string: The name given to the pay component - `classificationType` string: The category that this component falls into. - `description` string - `effectOnPay` 'ADDITION' | 'ADDITION_WITH_IN_OUT' | 'EMPLOYER_INFORMATIONAL' | 'REDUCTION': The effect that the pay component will have on the check amount. - `startDate` string, date-time: The date that the pay component is able to be applied on a check. - `endDate` string, date-time: The date that the pay component is not available to be applied on a check moving forward. - `jobId` string: This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. - `laborAssignmentId` string: This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. - `payRateId` string: The rate identifier for the workers compensation - `payRate` string: The rate amount that will be applied for this component. Used in conjunction with Hours or Units. - `payHours` string: The number of hours that will be applied for this component. Used in conjunction with rate - `payUnits` string: The number of units that will be applied for this component. Used in conjunction with rate. - `payAmount` string: The flat amount to be applied for this component. Not used with Rate, Hours, or Units. - `organization` OrganizationResourceInternal1: The organization which the worker is part of. - `organizationId` string: The unique identifier associated with this organizations representation. - `name` string: The name of the organization. - `number` string: The number assigned to the organization. - `level` string: The level number within the organizational structures hierarchy. - `lineDate` string, date-time: This is used optionally for specifying a date that the earning was generated on. - `memoed` boolean: This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. - `links` Link1[] - `href` string - `hreflang` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `templated` boolean ## Other responses - `400`: The request cannot be performed since the worker is in a state which does not allow this action(API-19),Invalid pay period ID (API-40) - `401`: Unauthorized - `403`: User doesn't have access to this endpoint (API-2), Client has been end dated (API-68) - `404`: Invalid resource ID (API-7) - `405`: Unsupported method type (API-59) - `406`: Unsupported Accept header - `500`: Internal Server Error. --- [API](https://skmtc.dev/paychex/apis/external-api.md) - [All operations](https://skmtc.dev/paychex/apis/external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paychex/apis/external-api/revisions/07161d3e073f?raw)