Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Federal Tax Details

Get a company's federal tax details

Retrieves a company's federal tax details including EIN verification status, tax payer type, filing form, and other federal tax configuration.

scope: company_federal_taxes:read

get/v1/companies/{company_id}/federal_tax_details

Path parameters

company_idstring required

The UUID of the company

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

tax_payer_type'C-Corporation' | 'S-Corporation' | 'Sole proprietor' | 'LLC' | 'LLP' | 'Limited partnership' | 'Co-ownership' | 'Association' | 'Trusteeship' | 'General partnership' | 'Joint venture' | 'Non-Profit' nullable

What type of tax entity the company is. One of:

  • C-Corporation
  • S-Corporation
  • Sole proprietor
  • LLC
  • LLP
  • Limited partnership
  • Co-ownership
  • Association
  • Trusteeship
  • General partnership
  • Joint venture
  • Non-Profit
taxable_as_scorpboolean

Whether the company is taxed as an S-Corporation. Tax payer types that may be taxed as an S-Corporation include:

  • S-Corporation
  • C-Corporation
  • LLC
filing_form'941' | '944'

The form used by the company for federal tax filing. One of:

  • 941 (Quarterly federal tax return form)
  • 944 (Annual federal tax return form)
has_einboolean

Whether company's Employer Identification Number (EIN) is present

ein_verifiedboolean

Whether the EIN has been successfully verified as a valid EIN with the IRS.

legal_namestring

The legal name of the company

effective_datestring

The date that these details took effect.

deposit_schedulestring

How often the company sends money to the IRS. One of:

  • Semiweekly
  • Monthly