Validate an EIN application request

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/filing/ein/validate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "valid": true,
  "errors": [
    {
      "source": "jsonschema",
      "code": "JSONSCHEMA_VALIDATION_FAILED",
      "path": "jurisdiction_registered_agent.agent_type",
      "message": "<string>"
    }
  ],
  "warnings": [
    {
      "source": "payload",
      "code": "UNKNOWN_FIELD",
      "path": "initial_board_size",
      "message": "<string>"
    }
  ]
}

Filing

Validate an EIN application request

Check an EIN application payload for field-shape errors without creating a filing — the same dry-run pre-flight the formation validate endpoints offer. Returns every field error in one pass, including the conditional principal_activity follow-ups for the selected category.

Beyond field shape, the check loads the referenced business and applies the entity-type rules the IRS application branches on — the LLC member questions and the corporation subtype — so it agrees with the create endpoint on those. A field that does not apply to the business’s entity type comes back as a warning and is ignored on submit. The responsible-party vault requirements still run only on the create endpoint, so a payload that passes here can still be rejected when you submit it.

POST

filing

ein

validate

Validate an EIN application request

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getpalm.com/v1/filing/ein/validate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "valid": true,
  "errors": [
    {
      "source": "jsonschema",
      "code": "JSONSCHEMA_VALIDATION_FAILED",
      "path": "jurisdiction_registered_agent.agent_type",
      "message": "<string>"
    }
  ],
  "warnings": [
    {
      "source": "payload",
      "code": "UNKNOWN_FIELD",
      "path": "initial_board_size",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Response

200 - application/json

Validation result

valid

boolean

required

True when the payload passed every compliance check

errors

object[]

required

All compliance errors found, empty when valid

Show child attributes

warnings

object[]

required

Non-blocking observations: a top-level field this jurisdiction does not accept (UNKNOWN_FIELD), an EIN field the business's entity type is never asked (NOT_APPLICABLE), or a declared LLC member count that disagrees with the listed members (MEMBER_COUNT_MISMATCH). None of these rejects the create — the field is ignored or filed as declared — so this is the only place they surface. Empty when there is nothing to report.

Show child attributes

Palm Introduction

API Introduction

Endpoints

Validate an EIN application request

Authorizations

Response