---
title: "Get all payroll blockers for a company"
method: GET
path: "/v1/companies/{company_uuid}/payrolls/blockers"
tags: ["Payrolls"]
---

# Get all payroll blockers for a company

`GET /v1/companies/{company_uuid}/payrolls/blockers`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/payrolls/blockers`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/payrolls/blockers/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of reasons that prevent the company from running payrolls. See the [Payroll Blockers guide](https://docs.gusto.com/embedded-payroll/docs/payroll-blockers) for a complete list of reasons. The list is empty if there are no payroll blockers.

scope: `payrolls:read`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Successful

- PayrollBlocker[]
  - `key` 'company_ownership_required' | 'contractor_only_company' | 'eftps_in_error' | 'geocode_error' | 'geocode_needed' | 'invalid_signatory' | 'missing_addresses' | 'missing_bank_info' | 'missing_bank_verification' | 'missing_employee_setup' | 'missing_federal_tax_setup' | 'missing_forms' | 'missing_industry_selection' | 'missing_pay_schedule' | 'missing_signatory' | 'missing_state_tax_setup' | 'needs_approval' | 'needs_onboarding' | 'pay_schedule_setup_not_complete' | 'pending_information_request' | 'pending_payroll_review' | 'pending_recovery_case' | 'soft_suspended' | 'suspended', required: A unique identifier for the payroll blocker reason. For a complete list of blockers and their meanings, see the [Payroll Blockers guide](https://docs.gusto.com/embedded-payroll/docs/payroll-blockers).
  - `message` string, required: A human-readable message describing the payroll blocker and what action is needed to resolve it.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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