Check Contractor Payments API
The Contractor Payments API from Check — 3 operation(s) for contractor payments.
The Contractor Payments API from Check — 3 operation(s) for contractor payments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/check-hq:check-hq-contractor-payments-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: check-api Contractor Payments API
version: '2025-01-01'
servers:
- url: https://sandbox.checkhq.com
security:
- sec0: []
tags:
- name: Contractor Payments
paths:
/contractor_payments:
post:
summary: Create a contractor payment
description: Creates a contractor payment.
operationId: create-a-contractor-payment
requestBody:
content:
application/json:
schema:
type: object
required:
- contractor
- payroll
- amount
properties:
contractor:
type: string
description: ID of the contractor to pay
payroll:
type: string
description: ID of the payroll this contractor payment will be paid out on
payment_method:
type: string
description: The way the contractor will be paid, either “direct_deposit” or "manual"
default: direct_deposit
amount:
type: string
description: The amount the contractor will be paid
default: '0.00'
reimbursement_amount:
type: string
description: The amount to reimburse the contractor
default: '0.00'
workplace:
type: string
description: The Workplace ID associated with this payment.
metadata:
type: string
description: Additional loosely structured information to associate with this contractor payment
format: json
paper_check_number:
type: string
description: For accounting. The check number associated with any printed checks. Can be updated even after the associated payroll has been approved. See [Get a paper check](https://docs.checkhq.com/reference/get-a-paper-check-2) for more details.
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Contractor Payments
/contractor_payments/{contractor_payment}:
get:
summary: Get a contractor payment
description: Returns the specified contractor payment.
operationId: get-a-contractor-payment
parameters:
- name: contractor_payment
in: path
description: ID of the contractor payment to return
schema:
type: string
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Contractor Payments
delete:
summary: Delete a contractor payment
description: ''
operationId: delete-a-contractor-payment
parameters:
- name: contractor_payment
in: path
schema:
type: string
required: true
responses:
'204':
description: '204'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Contractor Payments
/contractor_payments/{contractor_payment}/paper_check:
get:
summary: Get a paper check
description: 'Returns a paper check for the specified contractor payment.
Use an `Accept: application/pdf` request header to download the paper check as a PDF document.'
operationId: get-a-paper-check-2
parameters:
- name: contractor_payment
in: path
description: ID of the contractor payment to return
schema:
type: string
required: true
- name: Accept
in: header
description: application/pdf
schema:
type: string
- name: payment_id
in: query
description: Optional ID of a single net-pay-split payment (`pyt_…`). When provided, the check amount is scoped to just that split's payment (e.g. to reissue one failed direct deposit) instead of the full net pay. Rejected unless that payment can be reissued (e.g. it already paid, is still in flight, or was reversed).
schema:
type: string
responses:
'202':
description: '202'
content:
application/json:
examples:
Result:
value: '{"url": "string"}'
schema:
type: object
properties:
url:
type: string
example: string
'400':
description: '400'
content:
text/plain:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
tags:
- Contractor Payments
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: Authorization
x-bearer-format: bearer
x-default: YOUR_API_KEY
x-readme-fauxas: true
x-provenance:
method: searched
source: https://docs.checkhq.com/reference
harvested: '2026-10-14'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.checkhq.com/reference/add-filing-blockers.md
- https://docs.checkhq.com/reference/approve-a-correction.md
- https://docs.checkhq.com/reference/approve-an-external-payroll.md
- https://docs.checkhq.com/reference/approve-payroll.md
- https://docs.checkhq.com/reference/bulk-get-employee-tax-parameter-settings.md
- https://docs.checkhq.com/reference/bulk-get-employee-tax-params.md
- https://docs.checkhq.com/reference/bulk-update-employee-tax-parameters.md
- https://docs.checkhq.com/reference/cancel-a-payment.md
- https://docs.checkhq.com/reference/company-business-details.md
- https://docs.checkhq.com/reference/company-checklist-component.md
- https://docs.checkhq.com/reference/company-connect-bank-account.md
- https://docs.checkhq.com/reference/company-employee-setup.md
- https://docs.checkhq.com/reference/company-filing-authorization.md
- https://docs.checkhq.com/reference/company-pay-history.md
- https://docs.checkhq.com/reference/company-payment-setup.md
- https://docs.checkhq.com/reference/company-progress-tracker.md
- https://docs.checkhq.com/reference/company-signatory-agreements.md
- https://docs.checkhq.com/reference/company-tax-setup.md
- https://docs.checkhq.com/reference/company-team-setup.md
- https://docs.checkhq.com/reference/company-terms-of-service.md
- https://docs.checkhq.com/reference/company-verification-documents.md
- https://docs.checkhq.com/reference/contractor-roster.md
- https://docs.checkhq.com/reference/create-a-bank-account.md
- https://docs.checkhq.com/reference/create-a-company-provided-document.md
- https://docs.checkhq.com/reference/create-a-contractor-payment.md
- https://docs.checkhq.com/reference/create-a-correction.md
- https://docs.checkhq.com/reference/create-a-pay-schedule.md
- https://docs.checkhq.com/reference/create-a-payroll-item.md
- https://docs.checkhq.com/reference/create-a-post-tax-deduction.md
- https://docs.checkhq.com/reference/create-a-report-run.md
- https://docs.checkhq.com/reference/create-a-workplace.md
- https://docs.checkhq.com/reference/create-an-earning-code.md
- https://docs.checkhq.com/reference/create-an-earning-rate.md
- https://docs.checkhq.com/reference/create-an-external-payroll.md
- https://docs.checkhq.com/reference/create-company-tax-elections.md
- https://docs.checkhq.com/reference/create-net-pay-split.md
- https://docs.checkhq.com/reference/create-payroll.md
- https://docs.checkhq.com/reference/create-the-enrollment-profile.md
- https://docs.checkhq.com/reference/credit-limits.md
- https://docs.checkhq.com/reference/delete-a-bank-account.md
- https://docs.checkhq.com/reference/delete-a-company-benefit.md
- https://docs.checkhq.com/reference/delete-a-contractor-payment.md
- https://docs.checkhq.com/reference/delete-a-correction.md
- https://docs.checkhq.com/reference/delete-a-pay-schedule.md
- https://docs.checkhq.com/reference/delete-a-payroll-copy-1.md
- https://docs.checkhq.com/reference/delete-a-payroll-item-1.md
- https://docs.checkhq.com/reference/delete-a-payroll-item.md
- https://docs.checkhq.com/reference/delete-a-payroll.md
- https://docs.checkhq.com/reference/delete-a-post-tax-deduction.md
- https://docs.checkhq.com/reference/delete-a-webhook-config.md
- https://docs.checkhq.com/reference/delete-an-employee-benefit.md
- https://docs.checkhq.com/reference/download-a-report-run.md
- https://docs.checkhq.com/reference/download-a-setup-document.md
- https://docs.checkhq.com/reference/download-a-tax-package.md
- https://docs.checkhq.com/reference/employee-roster.md
- https://docs.checkhq.com/reference/employee-tax-setup.md
- https://docs.checkhq.com/reference/employee-tax-statements-1.md
- https://docs.checkhq.com/reference/employee-withholdings-setup.md
- https://docs.checkhq.com/reference/filing-preview-component.md
- https://docs.checkhq.com/reference/full-service-setup-submission.md
- https://docs.checkhq.com/reference/generate-contractor-onboard-link.md
- https://docs.checkhq.com/reference/generate-onboard-link.md
- https://docs.checkhq.com/reference/get-a-communication.md
- https://docs.checkhq.com/reference/get-a-company-filing.md
- https://docs.checkhq.com/reference/get-a-contractor-pay-statement.md
- https://docs.checkhq.com/reference/get-a-contractor-payment.md
- https://docs.checkhq.com/reference/get-a-correction-receipt-download.md
- https://docs.checkhq.com/reference/get-a-correction-receipt.md
- https://docs.checkhq.com/reference/get-a-correction.md
- https://docs.checkhq.com/reference/get-a-form.md
- https://docs.checkhq.com/reference/get-a-fulfillment-receipt-2.md
- https://docs.checkhq.com/reference/get-a-fulfillment.md
- https://docs.checkhq.com/reference/get-a-log.md
- https://docs.checkhq.com/reference/get-a-notification.md
- https://docs.checkhq.com/reference/get-a-paper-check-2.md
- https://docs.checkhq.com/reference/get-a-paper-check.md
- https://docs.checkhq.com/reference/get-a-pay-schedule.md
- https://docs.checkhq.com/reference/get-a-report-run.md
- https://docs.checkhq.com/reference/get-a-setup-document.md
- https://docs.checkhq.com/reference/get-a-setup.md
- https://docs.checkhq.com/reference/get-a-tax-package.md
- https://docs.checkhq.com/reference/get-a-tax.md
- https://docs.checkhq.com/reference/get-a-webhook-delivery.md
- https://docs.checkhq.com/reference/get-an-agency.md
- https://docs.checkhq.com/reference/get-an-earning-code.md
- https://docs.checkhq.com/reference/get-an-earning-rate.md
- https://docs.checkhq.com/reference/get-an-employees-paystubs.md
- https://docs.checkhq.com/reference/get-an-external-payroll.md
- https://docs.checkhq.com/reference/get-an-integration-partner-copy.md
- https://docs.checkhq.com/reference/get-child-support-payments-report.md
- https://docs.checkhq.com/reference/get-company-paydays.md
- https://docs.checkhq.com/reference/get-paper-checks-report.md
- https://docs.checkhq.com/reference/get-paper-checks.md
- https://docs.checkhq.com/reference/get-paydays.md
- https://docs.checkhq.com/reference/get-payroll-journal.md
- https://docs.checkhq.com/reference/get-payroll.md
- https://docs.checkhq.com/reference/integration-partners-copy.md
- https://docs.checkhq.com/reference/integration-partners.md
- https://docs.checkhq.com/reference/list-a-webhook-config.md
- https://docs.checkhq.com/reference/list-active-funding-strikes.md
- https://docs.checkhq.com/reference/list-agencies.md
- https://docs.checkhq.com/reference/list-bank-accounts.md
- https://docs.checkhq.com/reference/list-benefits.md
- https://docs.checkhq.com/reference/list-communications.md
- https://docs.checkhq.com/reference/list-companies.md
- https://docs.checkhq.com/reference/list-company-authorization-documents.md
- https://docs.checkhq.com/reference/list-company-benefits.md
- https://docs.checkhq.com/reference/list-company-filings.md
- https://docs.checkhq.com/reference/list-company-tax-documents.md
- https://docs.checkhq.com/reference/list-company-tax-elections.md
- https://docs.checkhq.com/reference/list-company-tax-parameter-settings.md
- https://docs.checkhq.com/reference/list-company-tax-parameters.md
- https://docs.checkhq.com/reference/list-contractor-forms.md
- https://docs.checkhq.com/reference/list-contractor-payments.md
- https://docs.checkhq.com/reference/list-contractor-tax-documents.md
- https://docs.checkhq.com/reference/list-contractors.md
- https://docs.checkhq.com/reference/list-corrections.md
- https://docs.checkhq.com/reference/list-earning-codes.md
- https://docs.checkhq.com/reference/list-earning-rates.md
- https://docs.checkhq.com/reference/list-employee-tax-documents.md
- https://docs.checkhq.com/reference/list-employee-tax-elections.md
- https://docs.checkhq.com/reference/list-employee-tax-parameter-settings.md
- https://docs.checkhq.com/reference/list-employee-tax-statements.md
- https://docs.checkhq.com/reference/list-employees-tax-parameters.md
- https://docs.checkhq.com/reference/list-employees.md
- https://docs.checkhq.com/reference/list-external-payrolls.md
- https://docs.checkhq.com/reference/list-forms.md
- https://docs.checkhq.com/reference/list-fulfillments.md
- https://docs.checkhq.com/reference/list-integration-accesses-1.md
- https://docs.checkhq.com/reference/list-integration-permissions-copy.md
- https://docs.checkhq.com/reference/list-integration-permissions.md
- https://docs.checkhq.com/reference/list-logs.md
- https://docs.checkhq.com/reference/list-net-pay-splits.md
- https://docs.checkhq.com/reference/list-notifications.md
- https://docs.checkhq.com/reference/list-pay-schedules.md
- https://docs.checkhq.com/reference/list-payments.md
- https://docs.checkhq.com/reference/list-payroll-items.md
- https://docs.checkhq.com/reference/list-payrolls.md
- https://docs.checkhq.com/reference/list-post-tax-deductions.md
- https://docs.checkhq.com/reference/list-report-runs.md
- https://docs.checkhq.com/reference/list-setup-documents.md
- https://docs.checkhq.com/reference/list-setups.md
- https://docs.checkhq.com/reference/list-tax-deposits.md
- https://docs.checkhq.com/reference/list-taxes.md
- https://docs.checkhq.com/reference/list-usage-records.md
- https://docs.checkhq.com/reference/list-usage-summaries.md
- https://docs.checkhq.com/reference/list-webhook-deliveries.md
- https://docs.checkhq.com/reference/list-workplaces.md
- https://docs.checkhq.com/reference/preview-a-correction.md
- https://docs.checkhq.com/reference/preview-an-external-payroll.md
- https://docs.checkhq.com/reference/preview-payroll.md
- https://docs.checkhq.com/reference/previous-payroll-provider-access.md
- https://docs.checkhq.com/reference/refund-a-payment.md
- https://docs.checkhq.com/reference/remove-filing-blockers.md
- https://docs.checkhq.com/reference/reopen-a-correction.md
- https://docs.checkhq.com/reference/reopen-a-pending-payroll.md
- https://docs.checkhq.com/reference/reopen-payroll.md
- https://docs.checkhq.com/reference/request-a-tax-package.md
- https://docs.checkhq.com/reference/request-embedded-setup.md
- https://docs.checkhq.com/reference/retry-a-payment.md
- https://docs.checkhq.com/reference/retry-a-webhook-delivery-in-sandbox.md
- https://docs.checkhq.com/reference/reveal-account-number.md
- https://docs.checkhq.com/reference/reveal-contractor-ssn.md
- https://docs.checkhq.com/reference/reveal-employee-ssn.md
- https://docs.checkhq.com/reference/run-payroll.md
- https://docs.checkhq.com/reference/sandbox-complete-disbursements.md
- https://docs.checkhq.com/reference/sandbox-complete-funding.md
- https://docs.checkhq.com/reference/sandbox-correction-complete-funding.md
- https://docs.checkhq.com/reference/sandbox-correction-fail-funding.md
- https://docs.checkhq.com/reference/sandbox-correction-start-processing.md
- https://docs.checkhq.com/reference/sandbox-fail-funding.md
- https://docs.checkhq.com/reference/sandbox-start-processing.md
- https://docs.checkhq.com/reference/submit-a-contractor-form.md
- https://docs.checkhq.com/reference/update-a-bank-account.md
- https://docs.checkhq.com/reference/update-a-company.md
- https://docs.checkhq.com/reference/update-a-correction.md
- https://docs.checkhq.com/reference/update-a-webhook-config.md
- https://docs.checkhq.com/reference/update-a-workplace.md
- https://docs.checkhq.com/reference/update-an-earning-rate.md
- https://docs.checkhq.com/reference/update-an-external-payroll.md
- https://docs.checkhq.com/reference/update-company-tax-elections.md
- https://docs.checkhq.com/reference/update-employee-tax-elections.md
- https://docs.checkhq.com/reference/update-payroll.md
- https://docs.checkhq.com/reference/update-the-enrollment-profile.md
- https://docs.checkhq.com/reference/validate-address.md
- https://docs.checkhq.com/reference/validate-an-external-payroll.md
- https://docs.checkhq.com/reference/void-a-payroll.md
- https://docs.checkhq.com/reference/workplace-roster.md
merge:
pages: 188
deduped: 195
conflicts_kept_first: 0