Check Usage API
The Usage API from Check — 2 operation(s) for usage.
The Usage API from Check — 2 operation(s) for usage.
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-usage-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 Usage API
version: '2025-01-01'
servers:
- url: https://sandbox.checkhq.com
security:
- sec0: []
tags:
- name: Usage
paths:
/usage/records:
get:
summary: List usage records
description: ''
operationId: list-usage-records
parameters:
- name: company
in: query
schema:
type: string
- name: category
in: query
schema:
type: string
enum:
- company
- employee
- contractor
- company_funding_failure
- payee_failed_payment
- wire
- one_day_payroll_processing_period
- name: resource_type
in: query
schema:
type: string
enum:
- company
- employee
- contractor
- payment_attempt
- name: period_start
in: query
schema:
type: string
format: date
- name: period_end
in: query
schema:
type: string
format: date
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
previous: null
next: null
results:
- category: wire
company: com_dXE2p4wCM251HmlJB0Mn
resource_type: payment_attempt
resource: pyt_vIFHhvyGN47ej1upyIT8
resource_information: {}
effective_at: '2024-06-01T00:00:00.000Z'
Payee Failed Payment:
summary: Payee Failed Payment
value:
previous: null
next: null
results:
- category: payee_failed_payment
company: com_dXE2p4wCM251HmlJB0Mn
resource_type: payment_attempt
resource: pya_vIFHhvyGN47ej1upyIT8
resource_information:
payee: emp_abc123xyz
payee_type: employee
effective_at: '2024-05-01T00:00:00.000Z'
schema:
type: object
properties:
previous: {}
next: {}
results:
type: array
items:
type: object
properties:
category:
type: string
example: wire
company:
type: string
example: com_dXE2p4wCM251HmlJB0Mn
resource_type:
type: string
example: payment_attempt
resource:
type: string
example: pyt_vIFHhvyGN47ej1upyIT8
resource_information:
type: object
properties: {}
description: Additional information about the resource. For payee_failed_payment records, contains payee and payee_type fields identifying the employee or contractor. Empty object for other categories.
effective_at:
type: string
example: '2024-06-01T00:00:00.000Z'
deprecated: false
tags:
- Usage
/usage/summaries:
get:
summary: List usage summaries
description: ''
operationId: list-usage-summaries
parameters:
- name: company
in: query
schema:
type: string
- name: category
in: query
schema:
type: string
enum:
- company
- employee
- contractor
- company_funding_failure
- payee_failed_payment
- wire
- one_day_payroll_processing_period
- name: period_start
in: query
schema:
type: string
format: date
- name: period_end
in: query
schema:
type: string
format: date
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"previous\": null,\n \"next\": null,\n \"results\": [\n {\n \"company\": \"com_dXE2p4wCM251HmlJB0Mn\",\n \"category\": \"company\",\n \"count\": 1,\n \"period_start\": \"2024-05-01\",\n \"period_end\": \"2024-05-31\"\n },\n {\n \"company\": \"com_dXE2p4wCM251HmlJB0Mn\",\n \"category\": \"employee\",\n \"count\": 15,\n \"period_start\": \"2024-05-01\",\n \"period_end\": \"2024-05-31\"\n },\n {\n \"company\": \"com_dXE2p4wCM251HmlJB0Mn\",\n \"category\": \"contractor\",\n \"count\": 8,\n \"period_start\": \"2024-05-01\",\n \"period_end\": \"2024-05-31\"\n },\n {\n \"company\": \"com_dXE2p4wCM251HmlJB0Mn\",\n \"category\": \"company_funding_failure\",\n \"count\": 1,\n \"period_start\": \"2024-05-01\",\n \"period_end\": \"2024-05-31\"\n },\n\t\t{\n \"company\": \"com_dXE2p4wCM251HmlJB0Mn\",\n \"category\": \"payee_failed_payment\",\n \"count\": 2,\n \"period_start\": \"2024-05-01\",\n \"period_end\": \"2024-05-31\"\n }\n ]\n}"
schema:
type: object
properties:
previous: {}
next: {}
results:
type: array
items:
type: object
properties:
company:
type: string
example: com_dXE2p4wCM251HmlJB0Mn
category:
type: string
example: company
count:
type: integer
example: 1
default: 0
period_start:
type: string
example: '2024-05-01'
period_end:
type: string
example: '2024-05-31'
deprecated: false
tags:
- Usage
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