Check Filings API
The Filings API from Check — 4 operation(s) for filings.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/check-hq:check-hq-filings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
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 Specification
openapi: 3.2.0
info:
title: check-api Filings API
version: '2025-01-01'
servers:
- url: https://sandbox.checkhq.com
security:
- sec0: []
tags:
- name: Filings
paths:
/filings:
get:
summary: List filings
description: List all filings
operationId: list-company-filings
parameters:
- name: company
in: query
description: Company ID for which to limit the filing results.
schema:
type: string
- name: jurisdiction
in: query
description: Jurisdictions to filter to, as lowercase region codes (e.g. `fed`, `ny`, `pa`). Repeat the parameter to provide multiple values.
explode: true
schema:
type: array
items:
type: string
- name: status
in: query
schema:
type: string
enum:
- pending
- blocked
- filed
- inapplicable
- name: year
in: query
schema:
type: integer
format: int32
- name: period
in: query
schema:
type: string
enum:
- annual
- q1
- q2
- q3
- q4
- january
- february
- march
- april
- may
- june
- july
- august
- september
- october
- november
- december
- other
- in: query
name: limit
schema:
type: integer
default: '25'
description: 'Number of results to return per page. Valid values range from 1 to 500. '
- in: query
name: is_amendment
schema:
type: boolean
description: Filter for amendment filings with true, and original filings with false. As a reminder, amendments only surface when the status is `submitted` or `filed`
- name: correction
in: query
description: Filter to company filings that a [correction](https://docs.checkhq.com/reference/the-correction-object) sourced during correction processing. Only filings with a `SOURCED` activity from the correction are included; filings the correction only re-synced are excluded.
schema:
type: string
- name: id
in: query
description: Filter the list to the specified IDs. For more details, check out the [Bulk Get Requests guide](https://docs.checkhq.com/docs/bulk-resource-get-requests).
schema:
type: array
items:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
next: null
previous: null
results:
- id: com_fil_9kL2mN8pQ4rS6tU1vW3x
company: com_7bF9dG2hJ5kM8nP1qR4s
year: 2024
period: q1
label: Federal Quarterly Filing - Q1
jurisdiction: fed
agency: agc_ukjABgbD0hQ3dfBRyMPD
due_at: '2024-04-15'
filed_at: '2024-04-12T16:30:25.847Z'
closed_at: '2024-04-08T00:00:00.000Z'
document: doc_3aE6fH9iL2mO5pR8sV1y
filing_attempts: 2
amends: null
amended_by: null
status: filed
status_history:
- status: inapplicable
status_at: '2024-01-15T10:30:15.423Z'
blocked_reasons: []
- status: pending
status_at: '2024-01-20T14:45:32.156Z'
blocked_reasons: []
- status: blocked
status_at: '2024-03-10T09:15:48.792Z'
blocked_reasons:
- type: applied_for_tax_id
resource_type: company_tax_param
resource: spa_h7zSw4NITCtef4Taf5yA
note: null
- status: pending
status_at: '2024-03-12T11:20:07.234Z'
blocked_reasons: []
- status: submitted
status_at: '2024-03-12T11:23:07.234Z'
blocked_reasons: []
- status: filed
status_at: '2024-04-12T16:30:25.847Z'
blocked_reasons: []
schema:
type: object
properties:
next:
type: string
previous:
type: string
results:
type: array
items:
type: object
properties:
id:
type: string
example: com_fil_9kL2mN8pQ4rS6tU1vW3x
company:
type: string
example: com_7bF9dG2hJ5kM8nP1qR4s
year:
type: integer
example: 2024
default: 0
period:
type: string
example: q1
label:
type: string
example: Federal Quarterly Filing - Q1
jurisdiction:
type: string
nullable: true
example: fed
description: Lowercase region code for the filing (`fed` or lowercased ISO 3166-2:US region code).
agency:
type: string
nullable: true
example: agc_ukjABgbD0hQ3dfBRyMPD
description: ID of the Agency that receives this filing.
due_at:
type: string
example: '2024-04-15'
filed_at:
type: string
example: '2024-04-12T16:30:25.847Z'
closed_at:
type: string
example: '2024-04-08T00:00:00.000Z'
document:
type: string
example: doc_3aE6fH9iL2mO5pR8sV1y
filing_attempts:
type: integer
example: 2
default: 0
amends:
type: array
items:
type: string
amended_by:
type: array
items:
type: string
status:
type: string
example: filed
status_history:
type: array
items:
type: object
properties:
status:
type: string
example: inapplicable
status_at:
type: string
example: '2024-01-15T10:30:15.423Z'
blocked_reasons:
type: array
items:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
tags:
- Filings
/filings/{filing_id}:
get:
summary: Get a filing
description: ''
operationId: get-a-company-filing
parameters:
- name: filing_id
in: path
description: ID of the company filing
schema:
type: string
required: true
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
id: com_fil_9kL2mN8pQ4rS6tU1vW3x
company: com_7bF9dG2hJ5kM8nP1qR4s
year: 2024
period: q1
label: Federal Quarterly Filing - Q1
jurisdiction: fed
agency: agc_ukjABgbD0hQ3dfBRyMPD
due_at: '2024-04-15'
filed_at: '2024-04-12T16:30:25.847Z'
closed_at: '2024-04-08T00:00:00.000Z'
document: doc_3aE6fH9iL2mO5pR8sV1y
filing_attempts: 2
amends: null
amended_by: null
status: filed
status_history:
- status: inapplicable
status_at: '2024-01-15T10:30:15.423Z'
blocked_reasons: []
- status: pending
status_at: '2024-01-20T14:45:32.156Z'
blocked_reasons: []
- status: blocked
status_at: '2024-03-10T09:15:48.792Z'
blocked_reasons:
- type: applied_for_tax_id
resource_type: company_tax_param
resource: spa_h7zSw4NITCtef4Taf5yA
note: null
- status: pending
status_at: '2024-03-12T11:20:07.234Z'
blocked_reasons: []
- status: submitted
status_at: '2024-03-12T11:23:07.234Z'
blocked_reasons: []
- status: filed
status_at: '2024-04-12T16:30:25.847Z'
blocked_reasons: []
schema:
type: object
properties:
id:
type: string
example: com_fil_9kL2mN8pQ4rS6tU1vW3x
company:
type: string
example: com_7bF9dG2hJ5kM8nP1qR4s
year:
type: integer
example: 2024
default: 0
period:
type: string
example: q1
label:
type: string
example: Federal Quarterly Filing - Q1
jurisdiction:
type: string
nullable: true
example: fed
description: Lowercase region code for the filing (`fed` or lowercased ISO 3166-2:US region code).
agency:
type: string
nullable: true
example: agc_ukjABgbD0hQ3dfBRyMPD
description: ID of the Agency that receives this filing.
due_at:
type: string
example: '2024-04-15'
filed_at:
type: string
example: '2024-04-12T16:30:25.847Z'
closed_at:
type: string
example: '2024-04-08T00:00:00.000Z'
document:
type: string
example: doc_3aE6fH9iL2mO5pR8sV1y
filing_attempts:
type: integer
example: 2
default: 0
amends:
type: array
items:
type: string
amended_by:
type: array
items:
type: string
status:
type: string
example: filed
status_history:
type: array
items:
type: object
properties:
status:
type: string
example: inapplicable
status_at:
type: string
example: '2024-01-15T10:30:15.423Z'
blocked_reasons:
type: array
items:
type: object
properties: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
tags:
- Filings
/filings/{filing_id}/add_blockers:
post:
summary: Add filing blockers
description: Add one or more blockers to a filing and return the updated filing. Blockers can only be added to filings in `blocked` or `pending` status. In production, partners can add only the `held_by_customer` blocker. In Sandbox, `filed_by_customer`, `customer_filing_required`, `invalid_ssn`, `inactive_account`, and `fein_tax_id_mismatch` are also accepted.
operationId: add-filing-blockers
parameters:
- name: filing_id
in: path
description: ID of the company filing
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
required:
- blockers
properties:
blockers:
type: array
description: List of blocker IDs to add to the filing. In production, only `held_by_customer` is supported. In Sandbox, `filed_by_customer`, `customer_filing_required`, `invalid_ssn`, `inactive_account`, and `fein_tax_id_mismatch` are also accepted.
items:
type: string
example: held_by_customer
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
id: com_fil_AaeJoEAzbqqc2D9GMr3R
company: com_vIFHhvyGN47ej1upyIT8
year: 2025
period: q1
label: Federal Quarterly Filing - Q1
jurisdiction: fed
agency: agc_ukjABgbD0hQ3dfBRyMPD
due_at: '2025-04-30'
filed_at: null
closed_at: '2025-04-25T00:00:00.000Z'
document: null
filing_attempts: 0
amends: null
amended_by: null
status: blocked
status_history:
- status: pending
status_at: '2025-04-01T10:00:00.000Z'
blocked_reasons: []
- status: blocked
status_at: '2025-04-20T15:30:00.000Z'
blocked_reasons:
- type: held_by_customer
resource_type: null
resource: null
note: null
schema:
type: object
properties:
id:
type: string
example: com_fil_AaeJoEAzbqqc2D9GMr3R
company:
type: string
example: com_vIFHhvyGN47ej1upyIT8
year:
type: integer
example: 2025
default: 0
period:
type: string
example: q1
label:
type: string
example: Federal Quarterly Filing - Q1
jurisdiction:
type: string
nullable: true
example: fed
description: Lowercase region code for the filing (`fed` or lowercased ISO 3166-2:US region code).
agency:
type: string
nullable: true
example: agc_ukjABgbD0hQ3dfBRyMPD
description: ID of the Agency that receives this filing.
due_at:
type: string
example: '2025-04-30'
filed_at:
type: string
nullable: true
example: null
closed_at:
type: string
nullable: true
example: '2025-04-25T00:00:00.000Z'
document:
type: string
nullable: true
example: null
filing_attempts:
type: integer
example: 0
default: 0
amends:
type: array
items:
type: string
amended_by:
type: array
items:
type: string
status:
type: string
example: blocked
status_history:
type: array
items:
type: object
properties:
status:
type: string
example: blocked
status_at:
type: string
example: '2025-04-20T15:30:00.000Z'
blocked_reasons:
type: array
items:
type: object
properties:
type:
type: string
example: held_by_customer
resource_type:
type: string
nullable: true
example: null
resource:
type: string
nullable: true
example: null
note:
type: string
nullable: true
example: null
'400':
description: '400'
content:
application/json:
examples:
Blockers Already Present:
value: "{\n \"message\": \"Blockers already present on filing: held_by_customer\",\n \"code\": \"blockers_already_present\"\n}"
Blockers Not Addable:
value: "{\n \"message\": \"Cannot add blockers: invalid_ssn\",\n \"code\": \"blockers_not_addable\"\n}"
Manual Issue Policy Violation:
value: "{\n \"message\": \"Action blocked by manual issue policy\",\n \"code\": \"manual_issue_policy_violation\"\n}"
schema:
type: object
properties:
message:
type: string
code:
type: string
deprecated: false
tags:
- Filings
/filings/{filing_id}/remove_blockers:
post:
summary: Remove filing blockers
description: Remove one or more blockers from a filing and return the updated filing. Only blockers that are currently open on the filing can be removed, and only while the filing is in `blocked` or `pending` status. Blockers that must be resolved through a Check support ticket, blockers Check applies automatically, and internal blockers cannot be removed through the API. Each blocker can be removed from a filing at most twice without a successful filing in between.
operationId: remove-filing-blockers
parameters:
- name: filing_id
in: path
description: ID of the company filing
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
required:
- blockers
properties:
blockers:
type: array
description: List of blocker IDs to remove from the filing. Each ID must be a blocker that is currently open on the filing.
items:
type: string
example: held_by_customer
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
id: com_fil_AaeJoEAzbqqc2D9GMr3R
company: com_vIFHhvyGN47ej1upyIT8
year: 2025
period: q1
label: Federal Quarterly Filing - Q1
jurisdiction: fed
agency: agc_ukjABgbD0hQ3dfBRyMPD
due_at: '2025-04-30'
filed_at: null
closed_at: null
document: null
filing_attempts: 0
amends: null
amended_by: null
status: pending
status_history:
- status: pending
status_at: '2025-04-01T10:00:00.000Z'
blocked_reasons: []
- status: pending
status_at: '2025-04-20T15:30:00.000Z'
blocked_reasons: []
schema:
type: object
properties:
id:
type: string
example: com_fil_AaeJoEAzbqqc2D9GMr3R
company:
type: string
example: com_vIFHhvyGN47ej1upyIT8
year:
type: integer
example: 2025
default: 0
period:
type: string
example: q1
label:
type: string
example: Federal Quarterly Filing - Q1
jurisdiction:
type: string
nullable: true
example: fed
description: Lowercase region code for the filing (`fed` or lowercased ISO 3166-2:US region code).
agency:
type: string
nullable: true
example: agc_ukjABgbD0hQ3dfBRyMPD
description: ID of the Agency that receives this filing.
due_at:
type: string
example: '2025-04-30'
filed_at:
type: string
nullable: true
example: null
closed_at:
type: string
nullable: true
example: null
document:
type: string
nullable: true
example: null
filing_attempts:
type: integer
example: 0
default: 0
amends:
type: array
items:
type: string
amended_by:
type: array
items:
type: string
status:
type: string
example: pending
status_history:
type: array
items:
type: object
properties:
status:
type: string
example: pending
status_at:
type: string
example: '2025-04-20T15:30:00.000Z'
blocked_reasons:
type: array
items:
type: object
properties:
type:
type: string
example: held_by_customer
resource_type:
type: string
nullable: true
example: null
resource:
type: string
nullable: true
example: null
note:
type: string
nullable: true
example: null
'400':
description: '400'
content:
application/json:
examples:
Blockers Not Found:
value: "{\n \"message\": \"Blockers not found on filing: held_by_customer\",\n \"code\": \"blockers_not_found\"\n}"
Blockers Require Zendesk Ticket:
value: "{\n \"message\": \"Cannot remove blockers: 1 blocker requires a support ticket: Filed by customer\",\n \"code\": \"blockers_require_zendesk_ticket\"\n}"
Blockers Not Removable:
value: "{\n \"message\": \"Cannot remove blockers: Company bad standing\",\n \"code\": \"blockers_not_removable\"\n}"
Manual Issue Policy Violation:
value: "{\n \"message\": \"Action blocked by manual issue policy\",\n \"code\": \"manual_issue_policy_violation\"\n}"
Too Many Blocker Removal Attempts:
value: "{\n \"message\": \"Too many attempts to remove the same blocker without a successful filing. Please ensure the blocker is resolved with the agency and then contact support.\",\n \"code\": \"too_many_blocker_removal_attempts\"\n}"
schema:
type: object
properties:
message:
type: string
code:
type: string
deprecated: false
tags:
- Filings
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
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/check-hq/refs/heads/main/openapi/check-hq-filings-api-openapi.yml