--- title: "Company Checks" method: POST path: "/companies/{companyId}/checks" tags: ["Payroll"] --- # Company Checks `POST /companies/{companyId}/checks` ## Request - Base URL: `https://api.paychex.com` - URL: `https://api.paychex.com/companies/{companyId}/checks` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Add a check for one or more worker within a company for an available pay period. ## Path parameters - `companyId` string, required ## Request body - CheckResource: The state representation of Labor Assignments within a company. - `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` boolean: This is used optionally for blocking the auto distribution of the earnings on the workers if they are setup for auto distribution. - `earnings` PayComponentResource[]: 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 unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `deductions` PayComponentResource[]: Deduction pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `checkDate` string: The check date - `informational` PayComponentResource[]: Informational pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `taxes` PayComponentResource[]: Tax pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string ## Response `201` successful operation - object - `content` CheckResource: The state representation of Labor Assignments within a company. - `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` boolean: This is used optionally for blocking the auto distribution of the earnings on the workers if they are setup for auto distribution. - `earnings` PayComponentResource[]: 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 unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `deductions` PayComponentResource[]: Deduction pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `checkDate` string: The check date - `informational` PayComponentResource[]: Informational pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `taxes` PayComponentResource[]: Tax pay components on the check. - `componentId` string: The unique identifier used to identify a pay component. - `checkComponentId` string: The unique identifier associated for the pay component on this check. - `code` string: The Paychex standard code number for the Pay Component, can be two digit. - `name` string: Name given to the pay component. - `classificationType` string: The category that this component falls into. - `description` string: The description of the Pay Component. - `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. - `appliesToWorkerTypes` string[]: List of workerTypes that the component can be applied to. - `jobId` string: This is used optionally for overriding a job when it needs to be different than 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 than the workers assignment distribution. This option is only available when the client has labor assignment. - `calculationType` string: Calculation type used by the pay component. - `payRateId` string: Unique identifier for this workers pay rate **This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex** - `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` OrganizationResource: The state representation of Organizations within a company. - `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. - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `lineDate` string, date-time: This is used optionally for specifying a date that the pay component 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` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string - `links` Link[] - `rel` string - `href` string - `hreflang` string - `media` string - `title` string - `type` string - `deprecation` string - `profile` string - `name` string ## Other responses - `400`: Amount should be between 0.00-9999.99 (API-28), Invalid Org ID (API-40), Required field missing (API-46), Required field ambiguous (API-47), Required field invalid (API-48), Pay period is in a state that will not allow checks to be modified (API-51), Empty request (API-52), All checks must have the same pay period in the request (API-53), Missing required field for one or more request (API-54), At least one worker doesn't belong to this client (API-55), Duplicate correlation ID (API-56), The pay component doesn't support the corresponding worker type (API-57), The pay component can't be REDUCTION type (API-60), Product was not set up for this client as of the check date of the given pay period (API-65), The pay rate's start date is after the provided PayPeriod's date range (API-69), This worker does not have a default pay rate set (API-70) - `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), Check is not allowed to be modified (API-51) - `406`: Unsupported Accept header - `413`: Post more than 100 checks per request (API-44) - `423`: Client locked (API-10) - `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)