---
title: "[Sandbox] Refresh filings"
method: POST
path: "/companies/{company}/refresh_filings"
---

# \[Sandbox\] Refresh filings

`POST /companies/{company}/refresh_filings`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/companies/{company}/refresh_filings`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/companies/:company/refresh_filings/post.ts> (a function with typed inputs; its response is checked against the schema)

Generate filings and employee tax statements for a company from its approved payroll data. Sandbox-only: in production this endpoint returns a 404.

Pass `payroll_ids` and `employee_ids` to limit generation to specific payrolls and employees, or omit both to generate data for the entire company, including employee W-2s. The work runs asynchronously and can take several minutes. A `company_filing` webhook with the `created` event is sent for each filing that is generated.

## Path parameters

- `company` string, required

## Request body

- object
  - `payroll_ids` string[]: IDs of the approved payrolls to generate filings for. Omit to include all of the company's payrolls.
  - `employee_ids` string[]: IDs of the employees to generate filings and tax statements for. Omit to include all of the company's employees.

## Response `202`

202

- object
  - `message` string

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/companies/:company/refresh_filings/post.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)