CHcheckhq

Add filing blockers

Changed on

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.

post/filings/{filing_id}/add_blockers

Request

Path parameters

filing_idstring required

ID of the company filing

Request body

blockersstring[] required

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.

Example request

{
  "blockers": [
    "held_by_customer"
  ]
}

Response

200

idstring
companystring
yearinteger
periodstring
labelstring
jurisdictionstring nullable

Lowercase region code for the filing (fed or lowercased ISO 3166-2:US region code).

agencystring nullable

ID of the Agency that receives this filing.

due_atstring
filed_atstring nullable
closed_atstring nullable
documentstring nullable
filing_attemptsinteger
amendsstring[]
amended_bystring[]
statusstring

Example response

{
  "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",
  "closed_at": "2025-04-25T00:00:00.000Z",
  "status": "blocked",
  "status_history": [
    {
      "status": "blocked",
      "status_at": "2025-04-20T15:30:00.000Z",
      "blocked_reasons": [
        {
          "type": "held_by_customer"
        }
      ]
    }
  ]
}

Changes