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.

This checks request-field shape only. The business existence check and the responsible-party vault requirements run 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. Currently one entry per top-level field this jurisdiction does not accept — such a field is ignored on create rather than rejected, so this is the only place it surfaces. Empty when there is nothing to report.

Show child attributes

⌘I

Palm Introduction

API Introduction

Endpoints

Validate an EIN application request

Authorizations

Response